Omnara

The open-source managed agent platform

A self-hostable alternative to Claude Managed Agents and OpenAI's Agents API.

  Website ·
  Quickstart ·
  Docs ·
  API ·
  Changelog ·
  Discord

Omnara is an open-source managed agent platform. Use the API to run AI agents
on any model and any machine, with tools, secrets, permissions, and streaming
built in. Self-host it for free under Apache 2.0, or use
Omnara Cloud.

Quickstart

Omnara Cloud

Sign in at app.omnara.com. Your first project comes
with a model provider (omnara-openrouter) and a pool of managed sandboxes
(default-pool), so this config runs as is. Save it as agent.yaml:

Launch it with the CLI (Node.js 22 or newer). If you're not logged in, the
first command opens your browser to sign in.

Chat with the agent in your terminal with npx omnara agents chat ,
or open it in the dashboard to watch its tool calls and reply.

Launch it from your code with the TypeScript SDK

Create an API key in the dashboard and export it as OMNARA_TOKEN, install the
SDK with npm install @omnara/sdk, and use the org and project IDs that
npx omnara config prints:

The quickstart shows the same flow with
the REST API.

To have your coding agent do the setup, give it this prompt:

Self-host

Requires Docker with Compose.

Open http://localhost:8000 and sign up. Local
development prints the verification link in docker compose logs api, so no
email provider is needed. To build from source instead of using published
images, run docker compose --profile app up -d --build.

A new instance has no models or machines yet. In the console, add a model
provider and a model, connect this computer under Machines, and share both
with your project. Sandboxes also work once your instance has a
public URL.

Point the CLI at your instance and log in:

In…