LibreAI / AI Agents / ouroboros
// agents · Q00/ouroboros

ouroboros

An Agent OS with interview-gated, budgeted evolution — one MCP server across 14 agent runtimes.

★ 6.2k stars⑂ 623 forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

ouroboros is an open-source ai agents project by Q00 (Q00/ouroboros on GitHub). It has 6,195 GitHub stars and 623 forks, is released under the MIT license, and was last updated on GitHub on 7 October 2026.

Repository
Q00/ouroboros
GitHub stars
6,195
Forks
623
License
MIT
Last updated on GitHub
7 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify what you want built

    Prepare the idea you will hand to the interview — Ouroboros starts by questioning you before any building happens.

  2. Install Ouroboros

    Use the one-line installer for your platform, or install the package with pipx/uv.

  3. Set up your runtime

    Run the setup for your agent runtime (Claude Code, Codex, Kiro, Copilot and more) so the MCP server is registered.

  4. Run your first interview

    Start with ooo setup and ooo interview, answer the gating questions, and let the staged, budgeted loop build and evaluate the result.

// features

Why people love it

Interview-gated building

Nothing is built until an interview pins down intent — the system questions you first, then executes against that contract.

Budgeted evolution loop

Agents evolve solutions over up to 30 generations with convergence checks and stagnation detection, under an explicit budget.

Staged evaluation

Work passes staged evaluation with a weighted drift measure across goal, constraints and ontology before it is accepted.

14 runtime integrations

The same workflow runs on Claude Code, Codex CLI, Gemini CLI, OpenCode, Copilot, Kiro, Hermes, Goose and more via pluggable runtime backends.

PAL model router

Routes work across Frugal, Standard and Frontier model tiers with auto-escalation on failure and auto-downgrade on success.

Replayable execution contract

Capability discovery, policy, directives and an event journal make agent execution replayable and auditable.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone Ouroboros if you want the source; most users use the installer in the next step.

    git clone https://github.com/Q00/ouroboros.git
    cd ouroboros
  2. Install Ouroboros

    Run the official installer for macOS/Linux/WSL2 (a PowerShell installer exists for Windows).

    curl -fsSL https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.sh | OUROBOROS_INSTALL_REF=readme-hero bash
  3. Set up and interview

    Initialize Ouroboros and start your first interview-gated build.

    ooo setup
    ooo interview "I want to build a task management CLI"
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Ouroboros?

Ouroboros is maintained by Q00 and contributors in the Q00/ouroboros repository.

Is Ouroboros free?

Yes — it is MIT licensed. You pay for the model usage of the runtime and models you connect.

Does it need a paid API key?

It drives external agent runtimes and models, so you need working access to at least one supported runtime (for example Claude Code or Codex); Ouroboros itself charges nothing.

How does it compare to a plain coding agent?

A plain agent starts coding immediately; Ouroboros gates work behind an interview, evaluates in stages, and evolves solutions within a budget — trading speed for control and repeatability.

How do I get started?

Run the one-line installer, then ooo setup for your runtime and ooo interview with your idea.

// keep exploring

Similar tools

AI Agents

moltis

Secure persistent personal agent server in one Rust binary — sandboxed, multi-provider, on your hardware

★ 2.9k starsMIT
View guide →
AI Agents

exa-mcp-server

Exa's MCP server for web search and crawling — give your AI agent a live, high-quality web index.

★ 5.1k starsMIT
View guide →
AI Agents

Monid

Monid — OpenRouter for agent tools: one base URL and one key give an agent 2,000+ tools across 72+ providers

★ 4.2k starsMIT
View guide →
AI Agents

open-cowork

Open Cowork: a desktop AI agent app with one-click Claude Code, MCP tools, skills, and VM sandboxing.

★ 2.2k starsMIT
View guide →
AI Agents

agent-device

Mobile app automation and verification built for AI coding agents — CLI, MCP server, and Node API

★ 4.9k starsMIT
View guide →
AI Agents

dbhub

A token-conscious MCP server that connects AI tools to Postgres, MySQL, SQLite and more.

★ 3.6k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if ouroboros is not the right fit.

Get ouroboros

Free and open — grab the source, star the repo, and start creating.