Ouroboros is a Python-based open-source general-purpose AI agent with self-evolving capabilities, durable memory, and a desktop/CLI runtime. It supports local GGUF models or remote APIs, persistent identity, and cross-task continuity.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (2 so far).
What it is
Ouroboros is an open-source, general-purpose AI agent whose identity, durable memory, and history continue across tasks and restarts. It can run as a native desktop app or via a headless CLI, with model inference configurable through remote providers or local GGUF models. The project emphasizes evolution, continuity, and coordination of a live swarm of specialist agents across tasks and external projects.
How it works
The runtime maintains its repository, durable memory, history, and interface on the user’s machine, while allowing model inference to be hosted remotely or locally. Ouroboros supports executive governance and reflection to reshape its surface (code, prompts, tools, dependencies) and to perform evolution campaigns that commit changes to Git history. It can operate with desktop and CLI gateways, and can coordinate multiple agents and external workspaces through a gateway-backed CLI.
Getting started
Install section shows platform-specific download and setup:
- macOS: Open DMG and install; optional CLI after the app is in Applications
- Linux: Extract, run Ouroboros, optional CLI install; note on browser tools dependencies
- Windows: Extract, run Ouroboros.exe; optional CLI install
Run from source: clone, create a Python 3.10+ virtual environment, install dependencies, and run the server with ouroboros server. CLI examples are provided for status, run, tasks, logs, and scheduling. The server binds to 127.0.0.1:8765 by default.
Example commands from README
git clone https://github.com/razzant/ouroboros.git
cd ouroboros
python3.11 -m venv .venv # any Python >= 3.10 is OK
source .venv/bin/activate
python -m pip install --upgrade pip setuptools wheel
python -m pip install -r requirements.txt
python -m pip install -e . --no-deps
ounroboros server
ounroboros status
ounroboros run --start "2+2?"
Recent releases
Latest releases include:
- v6.81.0 (2026-07-26)
- v6.74.4 (2026-07-22)
- v6.74.3 (2026-07-21)
- v6.73.2 (2026-07-20)
- v6.73.1 (2026-07-20)
These entries appear under the Releases section with brief changelog notes.
Traction
Stars: 734. Forks: 557. Open issues: 24. Language: Python. License: MIT. Created: 2026-02-11. Last push: 2026-07-28.