Skip to main content
Omnara is an open-source managed agent platform and a self-hostable alternative to Claude Managed Agents and OpenAI’s Agents API. 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.

Use cases

Omnara can be used to build agents for internal use cases or external use cases, such as:
  • Internal slack bots
  • Code review agents
  • Agents integrated in a product dashboard
Omnara exposes a web interface, CLI, and REST API to enable these use cases.

Build an agent

An agent starts as a small YAML config:
You can create and launch the agent in two ways:
  • Dashboard — click New agent in your project in the dashboard.
  • Programmatically - Omnara provides an API, Typescript SDK, and CLI to interact with Omnara
The quickstart provides a more detailed guide to setting up your first agent.

Core concepts

  1. An organization owns shared resources for your team: projects, secrets, model providers, and machines.
  2. Projects contains agents. Grants decide which shared resources the project can use.
  3. An agent is one durable conversation with its config, tool calls, and history. Profiles provide reusable agent configurations.
  4. You send inputs, stream events, and resolve interactions in an agent.
The concepts page gives a short overview of this model.

Start here

Quickstart

Write a config, create the grants, and launch an agent with the dashboard, the API, or the CLI

Concepts

The object model, the agent loop, and access control