selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Ouroboros logo

Self-host Ouroboros

v7.8.0

Self-creating AI agent with persistent identity

BetaOpen SourceMIT
Updated13 hours ago
LanguagePython
Setup difficultyModerate
Stars
1 587
Port
8765 (web runtime HTTP/WebSocket server)
Requires
Git
Install with Docker
Project room where Ouroboros built a 3D game, verified it with a screenshot, and served it locallyLive subagent swarm inside the Ouroboros desktop chat showing nested planner, builder, and researcher tasksOuroborosHub inside the app showing official reviewed skills, each security-reviewed before enablingCode, prompt, and memory growth across Ouroboros releases from v3.0.0 to v6.85 linemacOS DMG installation window showing drag-to-Applications arrow and Install CLI.command

What is Ouroboros?

This open-source AI agent runs on your own machine and maintains a continuous identity with durable memory across tasks and restarts. It can work on external projects, coordinate a swarm of specialist sub-agents, and autonomously modify its own implementation — including its codebase, architecture, prompts, tools, and dependencies. Available as a native desktop application for macOS, Windows, and Linux, plus a headless CLI, with a web interface on port 8765. Model inference supports remote APIs like OpenRouter, OpenAI, and Anthropic, as well as local GGUF models. Desktop bundles include CPython 3.10 and SQLite, so no separate Python installation is needed. Optional integrations connect to Codex, Claude Code, and Cursor subscriptions through the bundled Claudexor execution layer. Extensions like skills, transport bridges, widgets, and MCP tools are distributed via the OuroborosHub marketplace. Released under the MIT license with frequent updates.

Should you self-host Ouroboros?

Ouroboros scores 55/100 on selfhost.directory (how scoring works) and ranks #65 of 209 in AI Agents. It has 1 587 GitHub stars.

It shipped 7 stable releases in the past year. The latest, v7.8.0, came out on 23 October 2026. New versions land roughly every 4 days.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Orca (91/100, 108 815 stars). It scores higher overall, so compare the two before you pick. See Ouroboros vs Orca side by side.

Features

  • Agent swarm coordination
  • Autonomous self-evolution
  • Background consciousness
  • Constitutional governance (BIBLE.md)
  • Delegated coding via Claudexor
  • Headless CLI and desktop app
  • Local and remote model support
  • MCP (Model Context Protocol) Support
  • Persistent identity and memory
  • Project rooms for long-running work
  • Reviewed evolution with immune system
  • Self-change inspectability
  • Skills marketplace (OuroborosHub)
  • Web runtime with HTTP/WebSocket API

Ouroboros README

How to install Ouroboros

Install Ouroboros with Docker

Docker with BuildKit
Environment variables
OUROBOROS_NETWORK_PASSWORD, OUROBOROS_FILE_BROWSER_DEFAULT

docker build -t ouroboros-web . docker run --rm -p 8765:8765
-e OUROBOROS_NETWORK_PASSWORD='choose-a-password'
-e OUROBOROS_FILE_BROWSER_DEFAULT=/workspace
-v "$PWD:/workspace"
ouroboros-web

Runs the web runtime only (not native desktop shell). Bundles Chromium and WebKit for locked Playwright version. Needs Docker BuildKit. Persistent volumes and restart policy documented in docs/DEPLOYMENT.md.

Ouroboros releases & version history

More in AI Chat

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…