Installation

go get github.com/gojargo/jargo

jargo needs Go 1.26 or newer.

The default build needs no C toolchain

CGO_ENABLED=0 go build ./...

That works out of the box. Opus encode/decode and resampling are pure Go, and the two native runtimes are bound through purego, located and loaded at run time from their shared libraries, with nothing required at build time.

This is the property that makes jargo deployable as a single static binary. Keep it unless you have a measured reason not to.

Runtime libraries

Library	Needed for	Env var	Without it
ONNX Runtime	Silero VAD + Smart Turn v3	JARGO_ONNXRUNTIME_LIB	Bot still runs; falls back to STT endpointing, loses barge-in.
RNNoise	Optional input noise reduction	JARGO_RNNOISE_LIB	Bot runs without denoising.

Both are located by their conventional name on the loader's default search path when the variable is unset.

ONNX Runtime

Download a build for your platform from the onnxruntime releases; the onnxruntime-linux-* archive contains lib/libonnxruntime.so:

export JARGO_ONNXRUNTIME_LIB=/path/to/libonnxruntime.so     # Linux
export JARGO_ONNXRUNTIME_LIB=/path/to/libonnxruntime.dylib  # macOS
set JARGO_ONNXRUNTIME_LIB=C:\path\to\onnxruntime.dll        # Windows

The VAD and turn models themselves are embedded in the binary with go:embed, so there is nothing else to download or locate.

RNNoise

sudo apt-get install -y librnnoise0     # or build from source
export JARGO_RNNOISE_LIB=/path/to/librnnoise.so

Enable it per transport rather than globally:

params := transport.DefaultParams()
if filter, err := rnnoise.New(); err == nil {
    params.AudioInFilter = filter
}

rnnoise.New returns an error when the library is missing, which is the idiomatic way to make denoising optional. See examples/voice/openai.

Optional cgo build tags

Two higher-quality C backends are available. Both are opt-in and both need a C toolchain; the pure-Go defaults are used otherwise.

Tag	Replaces	Install
libsoxr	Pure-Go resampler with the SoX Resampler (highest quality)	sudo apt-get install -y libsoxr-dev
libopus	Pure-Go SILK encoder with the C Opus encoder (better speech)	sudo apt-get install -y libopus-dev

go build -tags libsoxr ./...
go build -tags libsoxr,libopus ./...

These are the only cgo in the tree.

Docker

The published base images bundle all of the above, so you do not have to think about any of it:

• gojargo/jargo-build: build stage, with the toolchain and C headers.
• gojargo/jargo: distroless runtime, carrying the ONNX Runtime, RNNoise, libsoxr, libgomp and libopus.

See Deploy with Docker for a copyable Dockerfile.

Verify

go run ./examples/echo    # then open http://localhost:8080

The echo bot needs no API keys and no ONNX Runtime. If you hear yourself back, the audio path works. Then continue to Your first bot.