Skip to main content
Omnara is an open source platform for running managed agents. It handles execution and state while you choose the models, tools, machines, and how users interact with each agent.

​
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