Installation¶

Prerequisites¶

Requirement	Details
Go	1.25 or later
CGO	Must be enabled (`CGO_ENABLED=1`). Required by the `sqlite3` and `sqlite-vec` drivers.
C compiler	`gcc` or `clang` (needed by CGO)
Git	For cloning the repository

Why CGO?

Lango uses SQLite for encrypted configuration storage and sqlite-vec for vector similarity search. Both require CGO-enabled builds. The Makefile sets CGO_ENABLED=1 automatically.

Build from Source¶

git clone https://github.com/langowarny/lango.git
cd lango
make build

The binary is written to bin/lango. To install it into your $GOPATH/bin:

make install

Go Install¶

You can also install directly with go install:

CGO_ENABLED=1 go install github.com/langowarny/lango/cmd/lango@latest

Verify Installation¶

lango version

You should see output like:

lango v0.2.1

Optional: Browser Tools¶

Some tools (browser automation) require a Chromium-based browser.

Chromium Dependency

If you plan to use browser automation tools, ensure a Chromium-based browser (Chrome, Chromium, or Edge) is installed on the system. Lango uses it via the Chrome DevTools Protocol for web page interaction.

Platform-Specific Builds¶

The Makefile provides cross-compilation targets:

# Linux amd64
make build-linux

# macOS arm64 (Apple Silicon)
make build-darwin

# All platforms
make build-all

Next Steps¶

Once installed, proceed to the Quick Start to configure and launch your agent.