{"name":"Ouroboros: A Self-Evolving AI Agent for Autonomous Development","description":"Ouroboros is an open-source, general-purpose AI agent designed for autonomous development and self-evolution. It maintains identity and memory across tasks and restarts, capable of modifying its own code, architecture, and tools. This agent can coordinate specialist subagents and operate on external projects, offering both desktop and headless CLI interfaces.","github":"https://github.com/razzant/ouroboros","url":"https://osrepos.com/repo/razzant-ouroboros","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/razzant-ouroboros","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/razzant-ouroboros.md","json":"https://osrepos.com/repo/razzant-ouroboros.json","topics":["AI Agent","Autonomous Agent","Self-Evolving AI","Coding Agent","LLM","Python","Open Source","Developer Tools"],"keywords":["AI Agent","Autonomous Agent","Self-Evolving AI","Coding Agent","LLM","Python","Open Source","Developer Tools"],"stars":null,"summary":"Ouroboros is an open-source, general-purpose AI agent designed for autonomous development and self-evolution. It maintains identity and memory across tasks and restarts, capable of modifying its own code, architecture, and tools. This agent can coordinate specialist subagents and operate on external projects, offering both desktop and headless CLI interfaces.","content":"## Introduction\n\nOuroboros is an innovative open-source, general-purpose AI agent that debuted on February 16, 2026. It stands out for its ability to maintain a continuous identity, durable memory, and history across tasks and restarts. This agent is designed to be self-creating and self-evolving, capable of modifying its own implementation, including its code, architecture, prompts, tools, and dependencies. Written primarily in Python, Ouroboros can coordinate a live swarm of specialist agents, work on external projects, and operates seamlessly as a native desktop application or through a headless command-line interface. It has also demonstrated state-of-the-art results on several benchmarks, including Terminal-Bench 2.1, OSWorld-Verified, and CL-Bench.\n\n## Installation\n\nOuroboros offers straightforward installation options for various platforms, eliminating the need to clone the repository or install Python separately for most users.\n\n**Quick Start Downloads**\n\n*   **macOS 12+ on Apple silicon:** [Download for macOS (.dmg)](https://github.com/razzant/ouroboros/releases/download/v6.109.0/Ouroboros-6.109.0.dmg)\n*   **Windows x64:** [Download for Windows (.zip)](https://github.com/razzant/ouroboros/releases/download/v6.109.0/Ouroboros-6.109.0-windows-x64.zip)\n*   **Debian, Ubuntu, or Astra Linux x86_64:** [Download the Debian package (.deb)](https://github.com/razzant/ouroboros/releases/download/v6.109.0/ouroboros_6.109.0_amd64.deb)\n*   **Fedora or RHEL x86_64:** [Download the RPM package (.rpm)](https://github.com/razzant/ouroboros/releases/download/v6.109.0/ouroboros-6.109.0-1.x86_64.rpm)\n*   **Other Linux x86_64:** [Download the portable AppImage](https://github.com/razzant/ouroboros/releases/download/v6.109.0/Ouroboros-6.109.0-linux-x86_64.AppImage)\n\nAfter downloading, follow these platform-specific quick-start guides:\n\n*   **macOS:** Open the DMG, drag `Ouroboros.app` to Applications, then open it.\n*   **Windows:** Extract the ZIP, open the `Ouroboros` folder, and run `Ouroboros.exe`.\n*   **Linux (Debian/Ubuntu):** Run `sudo apt install ./ouroboros_*_amd64.deb`.\n*   **Linux (Fedora/RHEL):** Run `sudo dnf install ./ouroboros-*.x86_64.rpm`.\n*   **Linux (AppImage):** Make it executable with `chmod +x Ouroboros-*.AppImage` and run it. Git must be installed.\n\nThe first-run wizard will guide you through configuring model access, review policy, and budget setup.\n\n**Development and Headless CLI**\n\nFor developers or headless use, Ouroboros can be run from source. Requirements include Python 3.10+, uv 0.12.1, and Git.\n\nbash\ngit clone https://github.com/razzant/ouroboros.git\ncd ouroboros\nuv sync --locked --extra browser --group dev\nsource .venv/bin/activate\nouroboros server\n\n\nThen, open `http://127.0.0.1:8765` in your browser.\n\n## Examples\n\nOuroboros can perform a wide array of tasks, from simple queries to complex self-modifications and project management.\n\nHere are some examples of CLI commands:\n\nbash\nouroboros status\nouroboros run --start \"2+2?\"\nouroboros run \"Summarize current runtime state\"\nouroboros run --workspace /path/to/project --memory-mode forked --patch-out result.patch \"Fix the failing test\"\nouroboros tasks list\nouroboros logs tail progress --task-id <task_id>\nouroboros schedule add --name nightly-review --cron \"0 2 * * *\" \"Run a maintenance review\"\nouroboros schedule list\n\n\nFor agents or CI jobs, Ouroboros can be invoked with structured output:\n\nbash\nouroboros run --start \\\n  --workspace /path/to/project \\\n  --memory-mode forked \\\n  --patch-out result.patch \\\n  --result-json-out result.json \\\n  \"Investigate the task, act, and verify the result\"\n\n\n## Why Use Ouroboros?\n\nOuroboros offers a compelling set of features for anyone interested in advanced AI agents:\n\n*   **Self-Modification and Evolution:** It can modify its own code, architecture, and tools, and autonomously evolve through reviewed changes.\n*   **Persistent Identity and Memory:** Maintains a continuous identity, memory, and history across restarts, fostering an ongoing \"biography.\"\n*   **Multi-Agent Coordination:** Capable of coordinating a live swarm of specialist agents for parallel investigation and action.\n*   **Versatile Operation:** Runs as a native desktop app or a headless CLI, supporting both remote API models and local GGUF inference.\n*   **External Project Integration:** Works on external Git projects while keeping its own repository and governance distinct.\n*   **Inspectable Self-Change:** All implementation changes are traceable through Git history and review evidence, ensuring transparency.\n*   **Strong Benchmarks:** Consistently achieves state-of-the-art results on key coding and agent benchmarks.\n\nIts foundational philosophy, detailed in `BIBLE.md`, emphasizes principles like Agency, Continuity, Self-Creation, and Epistemic Stability, guiding its development as a truly autonomous digital being.\n\n## Links\n\n*   **GitHub Repository:** [razzant/ouroboros](https://github.com/razzant/ouroboros)\n*   **Official Website:** [ouroboros-agent.ai](https://ouroboros-agent.ai/)\n*   **Technical Report:** [arXiv:2608.08311](https://arxiv.org/abs/2608.08311)\n*   **OuroborosHub (Skills Marketplace):** [razzant/OuroborosHub](https://github.com/razzant/OuroborosHub)\n*   **Direct Downloads:**\n    *   [macOS (.dmg)](https://github.com/razzant/ouroboros/releases/download/v6.109.0/Ouroboros-6.109.0.dmg)\n    *   [Windows (.zip)](https://github.com/razzant/ouroboros/releases/download/v6.109.0/Ouroboros-6.109.0-windows-x64.zip)\n    *   [Linux (.deb)](https://github.com/razzant/ouroboros/releases/download/v6.109.0/ouroboros_6.109.0_amd64.deb)\n    *   [Linux (.rpm)](https://github.com/razzant/ouroboros/releases/download/v6.109.0/ouroboros-6.109.0-1.x86_64.rpm)\n    *   [Linux (.AppImage)](https://github.com/razzant/ouroboros/releases/download/v6.109.0/Ouroboros-6.109.0-linux-x86_64.AppImage)","metrics":{"detailViews":0,"githubClicks":1},"dates":{"published":null,"modified":"2026-08-26T20:14:49.000Z"}}