OSA

OSA: the Optimal System Agent

OSA finds the signal in your work. Built on Signal Theory, it classifies
what you ask, filters the noise, and routes the work to the right model,
proactively, and on your machine.

Across your code, your ops, and the everyday busywork, OSA separates what matters
from the noise and does the work that counts. One command to install. Runs
locally. Works with any model.

Install in one command

macOS / Linux, paste this into a terminal:

Windows, paste this into PowerShell:

That's it. No Elixir, Erlang, or Rust required. The installer detects your
OS and CPU, downloads the prebuilt release from GitHub (a self-contained
Elixir/OTP release that bundles its own runtime, plus the prebuilt Rust TUI),
verifies its checksum, unpacks everything under ~/.osa (or %USERPROFILE%\.osa),
and puts the osa command on your PATH. The first run drops you into a short
setup wizard: pick a provider, paste a key or take the local Ollama default,
done. After that, type osa from anywhere on disk.

Prebuilt targets: linux-x64, macOS arm64, windows-x64. Pin a
specific release with OSA_VERSION=vX.Y.Z ($env:OSA_VERSION = "vX.Y.Z" on
Windows). On any other platform (macOS Intel, Linux arm64) the installer stops
and points you at the from-source script below.

Other ways to install

Already cloned the repo? From the repo root:

From source (any platform, installs toolchains as needed):

Docker: docker compose up -d

New to OSA? Start here

New here? The Getting Started guide takes you from install
to your first real task in a few minutes, with no prior setup knowledge needed.

Recommended setup (the easy path): on first run, the wizard asks which provider
to use. Pick Ollama Cloud (recommended) and the model glm-5.2:cloud. It
needs no GPU and no large downloads (Ollama…