Cloud agents that run on your own machines, with your own API keys.
Aven is a self-hosted platform for AI coding agents. Describe a task in a thread and an agent works in a folder on one of your machines, with a terminal and the tools already there, then opens the pull request as you. The server, the machines the agents run on and the model keys are yours.
- Runs on your laptop, a build machine or a VM, on the machine itself, in the folders you give it. Nothing is isolated, so use machines you own.
- Bring your own OpenAI, Anthropic, Azure OpenAI or OpenAI-compatible key. It stays encrypted on your server.
- One server, any number of machines: add a runner with one command.
- Aven Cloud runs a thread in a boat.dev sandbox of its own, with no setup for the person using it. It is off until the platform sets
AVEN_CLOUD_PROVIDERS=boatand a boat API key (AVEN_BOAT_API_KEY), and the sandbox has to reach the server at a public address.
macOS or Linux, with nothing installed beforehand (on Windows, use WSL2):
curl -fsSL https://raw.githubusercontent.com/anvia-hq/aven/main/install.sh | bashIt installs what is missing (git, and Docker for the server, after asking), the aven command, the server and a
runner on this machine, and opens Aven in your browser. Then add a model provider in Settings, connect
GitHub and start a thread. Update later with aven update.
Paste this to a coding agent (Claude Code, Codex) on the machine you want to set up:
Install Aven from https://github.com/anvia-hq/aven. Control plane (the server, plus a runner on this machine): run
curl -fsSL https://raw.githubusercontent.com/anvia-hq/aven/main/install.sh | bash, answer its prompts (for a server others can reach, add--domain <host> --owner-email <email>), then runaven doctorand fix anything notok. Runner only (another machine that runs the agents): ask me for the server's address and a runner token (Settings > Runtimes > create a runner), then runcurl -fsSL https://raw.githubusercontent.com/anvia-hq/aven/main/install.sh | bash -s -- --runner --url <address>/api --token <token>andaven doctor. To choose which folders a runner works in, add--dir <folder>to the runner command (its home by default). Never print or commit the token, and stop and ask me if git (or Docker, on the server) cannot be installed.
- Self-hosting: how it works, your own domain, more runners, updating, backup
- Cloud: a server others can reach, HTTPS, who can connect
- Connect GitHub
- Troubleshooting
- The
avencommand
Bun workspace monorepo; read AGENTS.md first, and docs/ for rules and decisions.
bun install
createdb aven
cp .env.example .env # then fill it in, with AVEN_RUNTIME_HOME=<this checkout>/.aven/runtime
bun run devHow installs and releases work: docs/decision/0073, 0074 and docs/rules/0005-releasing.md.
Licensed under the Apache License 2.0. See LICENSE.
"Aven" and the Anvia name and logos are trademarks of Anvia. The Apache License does not grant permission to use them; forks must use a different name and branding.
Outside contributions are welcome. See CONTRIBUTING.md.