Open source local-first AI agent. Rust-powered, zero runtime deps.
An AI agent that belongs on your desktop, not in the cloud.
Point it at a folder and ask it to do things: refactor a codebase, run a script and fix what breaks, research something across a dozen pages, or check your calendar and brief you every morning. It talks to 100+ model providers, runs as a single binary with no runtime to install, and reaches you through a web UI, a Discord bot, or your voice.
- Single binary, zero runtime deps — no Node, no Python, no Docker. Starts in ~540ms on ~14MB of RAM.
- Your machine, your model — runs entirely local against Ollama, or bring an API key. Nothing is sent anywhere you didn't configure.
- Reach it from anywhere you already are — web UI at
localhost:8765, a Discord bot with per-channel sessions, or voice in and out.
Models
- 100+ providers — OpenRouter, OpenAI, Anthropic, Google AI, GitHub Copilot, OpenAI Codex, Ollama, Groq, DeepSeek, xAI, AWS Bedrock, Azure, and more
- OAuth login for GitHub Copilot, Google, and OpenAI Codex — no API keys needed
Interfaces
- Web UI — chat interface at
localhost:8765 - Discord bot — slash commands, per-channel/per-user sessions, live tool progress
- Voice I/O — Whisper STT + Piper TTS, with browser fallback
What it can do
- 30+ built-in tools — file read/write/patch, code execution (Python/Node/Bash), grep/glob, LSP, web fetch and search, process control
- Desktop assistant tools — calendar, weather, news, system status, persistent memory
- Jobs scheduling — cron-based reminders, recurring tasks, daily briefings
Extending it
- Visual workflow editor — node-based drag-and-drop automation with conditions, loops, and branching
- Skills system — installable
.oskillbundles for custom integrations
Download the latest release for your platform from GitHub Releases:
| Platform | Asset |
|---|---|
| Windows | osagent-windows-x86_64-setup.exe |
| Linux (x86_64) | osagent-linux-x86_64.deb |
| macOS (Apple Silicon) | osagent-macos-arm64.dmg |
Then run the launcher and follow the wizard: pick a provider (OAuth or API key), pick a workspace folder, done — your browser opens to http://localhost:8765.
Prefer the terminal:
osagent start # Start with default config
osagent start -w /path/to/project # Start with a specific workspaceAuto-updates are served via https://osa.fuckyourcdn.com/releases/latest.json.
Measured with in-repo runtime benchmarks (release, provider-free workloads, 10 runs on 2026-04-08):
| Metric | OSAgent |
|---|---|
| Startup to ready | ~543ms |
| Ready RSS | ~13.68MB |
| Idle RSS | ~22.66MB |
| Install size | ~50MB (deb/dmg) |
cargo run --release --bin osagent-bench -- --profiles release --iterations 10Config lives at ~/.osagent/config.toml. A minimal one is just a provider:
[[providers]]
provider_type = "openrouter"
api_key = "sk-or-v1-..."
model = "anthropic/claude-sonnet-4"
[agent]
workspace = "~/.osagent/workspace"Full config reference
[server]
bind = "127.0.0.1"
port = 8765
password = "$2b$12$..." # bcrypt hash (optional)
[[providers]]
provider_type = "openrouter"
api_key = "sk-or-v1-..."
model = "anthropic/claude-sonnet-4"
[agent]
workspace = "~/.osagent/workspace"
max_tokens = 4096
[tools]
allowed = ["bash", "read_file", "write_file", "grep", "glob", "code_python"]
[discord]
token = "your-bot-token"
allowed_users = ["1234567890"]Extend OSAgent with custom integrations:
mkdir my-skill && cd my-skill
# Create SKILL.md (agent instructions) and manifest.toml (metadata)
zip -r ../my-skill.oskill *
# Install via Settings → Skills in the Web UISee examples/skills/ for examples.
git clone https://github.com/jaylikesbunda/OSAgent.git
cd OSAgent
.\build-launcher.ps1 -InstallerRelease artifacts:
- Windows:
launcher/target/release/bundle/nsis/*.exe(installer) - Linux:
launcher/target/release/bundle/deb/*.deb - macOS:
launcher/target/release/bundle/macos/*.app
See RELEASING.md for the full release flow.
What do I need to get started? Bring your own model. Use GitHub Copilot or OpenAI Codex via OAuth, any OpenRouter/Anthropic API key, or Ollama for fully local models. Download the binary, run it, open localhost:8765.
Can I run it fully offline? Yes. Point at a local Ollama instance and you're off-grid.
How does Discord integration work? Add your bot token to config. OSAgent becomes a Discord bot with per-channel sessions, slash commands, and real-time tool progress. Same binary as the web UI.
Is it a coding agent or a general assistant? Both — it ships LSP, patch, and code-execution tools alongside calendar, weather, and scheduling ones. Trim [tools].allowed to whichever half you actually want.