Ouro

Ouro is derived from Ouroboros—the ancient symbol of a serpent consuming its own tail to form a perfect circle. It represents the ultimate cycle: a closed loop of self-consumption, constant renewal, and infinite iteration.

At Ouro AI Lab, this is our blueprint. We are building the next generation of AI agents capable of autonomous evolution—systems that learn from their own outputs, refine their own logic, and achieve a state of infinite self-improvement.

Two Modes, One Agent

Ouro ships with a unified agent core and two deployment modes:

	CLI Mode	Bot Mode
What	Interactive REPL + one-shot task execution	Persistent IM assistant (Lark, Slack)
Install	uv tool install ouro-ai	uv tool install ouro-ai
Run	ouro-cli	ouro-bot
Guide	CLI Guide	Bot Guide

Architecture

Ouro is organized into three layers with strict downward-only imports:

*Each layer has its own README — start with the [umbrella overview](ouro/README.md), then drill into [`core`](ouro/core/README.md), [`capabilities`](ouro/capabilities/README.md), or [`interfaces`](ouro/interfaces/README.md).*

Features

🤖 Agent Swarm — Multi-Agent Swarm with Persistent Tasks

The flagship feature. Enable with `ENABLE_AGENT_SWARM=true` in `~/.ouro/config`.

• Persistent Task Store — SQLite-backed tasks with dependency graphs (task_create, task_claim, task_update, task_list, `task_ge