Raven AI Agent
by EverMind-AIThe Harness of Harnesses • built for RSI: a trusted, persistent, self-evolving multi-agent ecosystem for all-domain collaboration.
Raven is an open-source ai agent by EverMind-AI, written mainly in Python, with 5,952 GitHub stars and the Apache-2.0 license. Its code was last updated Nov 1, 2026.
Website · Documentation · 中文
</div> <br>❯❯ What's New
❯ Multi-Agent Trajectory Observability
Every agent, every turn, every step — on one timeline. Raven's new trajectory view renders a running multi-agent session as a live waterfall, from the whole run down to a single step.
https://github.com/user-attachments/assets/abb0a5e9-1c37-48bd-9be0-1c9267293337
What is Raven
<p align="center"> <a href="https://github.com/user-attachments/assets/f400d693-d8cf-46eb-b846-6948f66f6fed"><img src="https://github.com/user-attachments/assets/f400d693-d8cf-46eb-b846-6948f66f6fed" alt="Raven one surface, all agents workflow" width="100%"></a> </p> <p align="center"><em>One Surface, All Agents: Raven generates DAGs and orchestrates multiple specialized agents for complex tasks.</em></p>Raven is the harness of harnesses, built for recursive self-improvement (RSI). As a Host Agent, it brings built-in and third-party agents together to carry out complex tasks. Its modular architecture supports iterative improvement of Raven's own harness: proposing changes to how agents plan and act, evaluating those changes, and adopting improvements that pass validation. Powered by EverOS, Raven carries memory and context across sessions to support this process.
Built-in Agents: Raven-Research, Raven-Code, Raven-Design, and Raven-Oncall support research, coding, visual design, and unattended workflow automation.
<p align="center"> <a href="https://github.com/user-attachments/assets/1756ab94-706d-4c07-b8b3-3ef6dd8a147f"><img src="https://github.com/user-attachments/assets/1756ab94-706d-4c07-b8b3-3ef6dd8a147f" alt="Multi-Agent Orchestration Benchmark: Node F1, Edge F1, Partial Order Accuracy, and Exact Match Rate" width="100%"></a> </p> <p align="center"><em>Raven's Performance on the Multi-Agent Orchestration Benchmark</em></p>❯❯ Showcase
These are three complete projects delivered by Raven. In each case, Raven drove a team of specialized agents from the initial brief or objective through execution to a complete set of final deliverables.
❯ THRESHOLD: a complete game development project
The brief came from a person; Raven completed the entire project. Working autonomously for about 4 days, Raven completed 42 rounds of planning, development, and verification to build a playable first-person shooter in Godot 4, centered on an arena boss fight. The full deliverable includes the game, its poster, presentation, and website, all produced by Raven.
<table> <tr> <td colspan="2" valign="top"><p align="center"><b>Gameplay video</b></p></td> <td width="22.2%" valign="top"><p align="center"><b><a href="https://livxue.github.io/threshold/en/">Website ↗</a></b></p></td> </tr> <tr> <td colspan="2" valign="top">https://github.com/user-attachments/assets/44724e3e-6564-467a-b422-473aa8f474bd
</td> <td rowspan="3" width="22.2%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/8cfd513f-fba9-432d-b020-51dba0a7faeb"><img src="https://github.com/user-attachments/assets/8cfd513f-fba9-432d-b020-51dba0a7faeb" alt="The THRESHOLD website as one long capture: hero, fight, kill cam, attack tells, evolution, making-of and footer" width="100%"></a></p></td> </tr> <tr> <td width="46.2%" valign="top"><p align="center"><b>Poster</b></p></td> <td width="31.6%" valign="top"><p align="center"><b>Presentation</b> · <b><a href="https://github.com/LivXue/Raven/releases/download/showcase-decks-2026-09-25/Raven-Game-0925.pptx">PPTX ↓</a></b></p></td> </tr> <tr> <td width="46.2%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/a12e76d1-e7b1-4a7e-a3ba-1f3b5492fb50"><img src="https://github.com/user-attachments/assets/a12e76d1-e7b1-4a7e-a3ba-1f3b5492fb50" alt="THRESHOLD poster: the Warden towers over the player on a molten arena floor" width="100%"></a></p></td> <td width="31.6%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/3852c187-3412-4501-9b62-809a3dfd0b81"><img src="https://github.com/user-attachments/assets/3852c187-3412-4501-9b62-809a3dfd0b81" alt="Cover, slides and closing slide of the THRESHOLD deck" width="100%"></a></p></td> </tr> </table>❯ Raven RSI: recursive self-improvement in practice
AI that improves AI, with the entire project completed by Raven. Given a task and evaluation criteria it cannot modify, Raven RSI independently plans each round, writes code, runs experiments, and evaluates the results. In nanochat pre-training experiments, it completed 172 training runs across 7 rounds without a single crash, reducing val_bpb by 5.8% within the same 20-minute, single-GPU budget. The same process reduced overshoot in a dam-break simulation by three orders of magnitude and completed an FEA limit-load search in 8 rounds of bisection. The complete deliverable includes the experimental results, visualizations, poster, presentation, and project website, all produced by Raven.
❯ Raven: a complete product launch project
One raven, a whole flock of specialists. Raven completed the entire project. Its launch kit brings together a browser-based physics mini-game, a 16-slide product overview, posters in English and Chinese, and the README you are reading now, all produced by Raven.
<table> <tr> <td colspan="2" valign="top"><p align="center"><b>Physics mini-game</b> · <b><a href="https://livxue.github.io/angry-raven/">Play online ↗</a></b></p></td> <td width="19%" valign="top"><p align="center"><b>README</b></p></td> </tr> <tr> <td colspan="2" valign="top">https://github.com/user-attachments/assets/dd186b6d-3752-4c59-89c7-eeea5c6fa962
</td> <td rowspan="3" width="19%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/1bb3bef1-e701-4609-9b14-6de6877c9e5c"><img src="https://github.com/user-attachments/assets/1bb3bef1-e701-4609-9b14-6de6877c9e5c" alt="The top of the Raven README as one long capture: banner, introduction, the four built-in agents with their benchmarks, and runtime self-evolution" width="100%"></a></p></td> </tr> <tr> <td width="46.5%" valign="top"><p align="center"><b>Poster</b></p></td> <td width="34.5%" valign="top"><p align="center"><b>Presentation</b> · <b><a href="https://github.com/LivXue/Raven/releases/download/showcase-decks-2026-09-25/Raven-Overview-0925.pptx">PPTX ↓</a></b></p></td> </tr> <tr> <td width="46.5%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/4044db80-10f6-4963-9800-218125630c2b"><img src="https://github.com/user-attachments/assets/4044db80-10f6-4963-9800-218125630c2b" alt="Raven poster: a raven on a standing stone above sea cliffs at sunset, over the line One raven. A whole flock of specialists." width="100%"></a></p></td> <td width="34.5%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/2e19674e-83a8-4a77-a114-39f906c240d0"><img src="https://github.com/user-attachments/assets/2e19674e-83a8-4a77-a114-39f906c240d0" alt="Cover, slides and closing slide of the Raven overview deck" width="100%"></a></p></td> </tr> </table>❯❯ Built-in Agents
Raven's modular architecture is designed for harness self-evolution and subagent creation. Its four built-in agents deliver state-of-the-art (SOTA) performance in their respective domains, combining reusable harness components with domain-specific tools, skills, and agent loops. Raven can delegate a focused task to a single agent or orchestrate multiple agents within a shared workflow. The harness they share is refined by the Raven Evolver, a separate tool that consumes Raven as a library and evaluates candidate harness changes against benchmarks; it develops the agents rather than running inside them.
All four agents are built in and ready for orchestration out of the box.
❯ Raven-Research
Raven-Research enables autonomous deep research for complex questions, literature reviews, and technical analysis. It delivers clear, structured reports with traceable sources, helping users understand unfamiliar domains, compare alternatives, and make informed decisions.
<p align="center"> <a href="https://github.com/user-attachments/assets/9dbc1aaa-3477-4871-b3fd-a42405c6ef02"><img src="https://github.com/user-attachments/assets/9dbc1aaa-3477-4871-b3fd-a42405c6ef02" alt="DeepResearch Mixed: Accuracy, Input Tokens, Output Tokens, and Cost" width="100%"></a> </p> <p align="center"><em>Raven-Research's performance on the DeepResearch Mixed benchmark</em></p>❯ Raven-Code
Raven-Code enables agentic software development, turning requirements into working, tested code. It supports feature implementation, debugging, refactoring, data processing, and data analysis, helping users build new capabilities, resolve issues, and improve code quality while following their project's conventions.
<p align="center"> <a href="https://github.com/user-attachments/assets/a516ebc2-f0b4-47d4-b970-7dfd492adc0e"><img src="https://github.com/user-attachments/assets/a516ebc2-f0b4-47d4-b970-7dfd492adc0e" alt="Coding Benchmarks: SWE-bench Pro, SWE-bench Verified, WorkBuddy-Code Reward, and SWE-Refactor" width="95%"></a> </p> <p align="center"><em>Raven-Code's performance on coding benchmarks</em></p> <p align="center"> <a href="https://github.com/user-attachments/assets/75f60aa2-3e2f-42fb-aa51-aa111bf078d0"><img src="https://github.com/user-attachments/assets/75f60aa2-3e2f-42fb-aa51-aa111bf078d0" alt="DataAgentBench (2026-08-24 Live): Raven-Code with Opus-5 achieves 0.8762 Pass@1" width="95%"></a> </p> <p align="center"><em>Raven-Code tops on DataAgentBench for data analysis (2026-08-24 Live)</em></p>❯ Raven-Design
Raven-Design performs visual design, turning ideas and content into polished visual deliverables. It creates PowerPoint slide decks, brand assets, charts, diagrams, and web interfaces, refining layout, typography, and visual consistency to help users communicate clearly and bring their ideas to life.
<p align="center"> <a href="https://github.com/user-attachments/assets/c42ff722-8aab-40ec-82e3-0655a859a9d9"><img src="https://github.com/user-attachments/assets/c42ff722-8aab-40ec-82e3-0655a859a9d9" alt="PresentBench: Raven-Design, Claude Code, and public leaderboard scores" width="95%"></a> </p> <p align="center"><em>Raven-Design tops on PresentBench for slide generation</em></p> <p align="center"> <a href="https://github.com/user-attachments/assets/103c49f8-f31d-4735-8bfd-84cae9baee46"><img src="https://github.com/user-attachments/assets/103c49f8-f31d-4735-8bfd-84cae9baee46" alt="Visual Design: Raven-Design, Claude Code, and Hermes on ArtifactsBench Dashboard, ArtifactsBench SVG, and GDPVal" width="95%"></a> </p> <p align="center"><em>Raven-Design's performance on visual design benchmarks</em></p>❯ Raven-Oncall
Raven-Oncall enables unattended workflow automation for experimentation, optimization, and continuous monitoring. It autonomously manages workflows from start to completion, sustaining progress over hours or overnight, delivering results, and involving users only when human judgment is needed.
<p align="center"> <a href="https://github.com/user-attachments/assets/bffd0fa2-e750-4f09-b74a-09452765a99d"><img src="https://github.com/user-attachments/assets/bffd0fa2-e750-4f09-b74a-09452765a99d" alt="AI4AI (Nanochat 50M Pretraining): Bits Per Byte (BPB), Runtime, Tokens, and Cost" width="95%"></a> </p> <p align="center"><em>Raven-Oncall significantly outperforms Claude Code on both quality and cost for AI4AI tasks</em></p> <p align="center"> <a href="https://github.com/user-attachments/assets/aafe30ca-6693-4d30-956e-73debf3ef2c9"><img src="https://github.com/user-attachments/assets/aafe30ca-6693-4d30-956e-73debf3ef2c9" alt="AI4S Internal Benchmark: Success Rate, Average Total Runtime, Average Total Tokens, and Average Cost" width="95%"></a> </p> <p align="center"><em>Raven-Oncall significantly outperforms Claude Code on both success rate and cost for AI4S tasks</em></p>❯❯ Runtime Self-Evolution
Raven is built for this from the ground up. Its agent loop is split into four decoupled strategy modules — Memory for what a turn gets to see, Planning for how it approaches the work, Capability for which tools an iteration exposes, Action for what to do next and for judging it before it runs. A Curator keeps rewriting those four seats: a setting, or a small piece of judgement code written for that agent. What it changes belongs to that agent alone, and once installed the agent runs on it.
A Curator changes more than the prompt — the tools and outside services it reaches for, the skills and procedures it follows, and its own judgement at each point can all be replaced. It keeps going round after round — you put it to work, you say what was wrong, it reworks — until you are satisfied, until it has nothing left worth changing, or until the round budget runs out. Two things hold the quality: nothing is installed before it is verified, and a failed check sends it back; and a round's signals normally reach it with the reference answer stripped out, which limits how directly the answer is exposed. The Curator is experimental: it ships with the repository rather than the installed package.
A Persona is the first thing it builds. Describe the assistant you want and the Curator assembles one: a lead role that talks to you, and specialists drawn from the agents you already have. What you asked for lands in that assistant's harness — its division of work, the tools it may reach for, and the checks it must pass before it acts.
Describe what you need once. Raven assembles the assistant, keeps improving it while you work, and afterwards a sentence is enough to put it to work again.
❯❯ Connect Third-Party Agents
Raven can connect to and orchestrate agents via ACP, CLI, or OpenAI-compatible APIs, with presets for 15 third-party agents and nine Mirasim-routed presets to simplify setup, task delegation, and coordination across shared workflows. Try these agents in Raven through a unified interface!
<p align="center"> <img src="https://github.com/user-attachments/assets/acd47004-c0b8-4079-87f0-9b77c6731e89" width="80%" alt="Third-party agents in Raven's Agent Hub"> </p>The roster also includes MiniMax Code over its native ACP server (mcode acp), DSH (DeepSeek Harness) over the ACP profile it ships (dsh --profile acp), and nine Mirasim-routed presets such as Claude Code-Mirasim, which run the same agents on Mirasim's accounts and model routes.
❯❯ News
- 📣 2026-09-30 — Raven's technical report reached #1 on Hugging Face Daily Papers — daily (2026-09-30), weekly (2026-10-04) and monthly (2026-10-10).
❯❯ Quick Start
🤖 Install with Your Agent
Let your own agent install Raven for you. Copy this prompt into any agent that can read a web page and run shell commands, such as Claude Code or Codex:
Read https://evermind-ai.github.io/Raven/quick-start/ and follow it to install Raven, or to update it if it is already installed.
📦 Install
Linux, macOS, or WSL2:
curl -fsSL https://raven.evermind.ai/install.sh | bash
Native Windows PowerShell:
irm https://raven.evermind.ai/install.ps1 | iex
Windows PowerShell 5.1, the version built into Windows, cannot follow that URL's
redirect and stops with (308) Permanent Redirect. If you see that error, use the
direct installer URL instead:
irm https://raw.githubusercontent.com/EverMind-AI/Raven/refs/heads/main/install.ps1 | iex
Or run it in a container, with nothing on the host but Git and Docker:
git clone https://github.com/EverMind-AI/Raven.git
cd Raven
docker compose -f docker/docker-compose.yml up
Then open http://localhost:18793 in your browser. Prerequisites are
Git and Docker with
Docker Compose. See
docker/README.md for what comes up, how the page signs
itself in, and how to run it behind a remotely exposed port.
Or install from a source checkout, to develop against the code or to run what has not been released yet:
git clone https://github.com/EverMind-AI/Raven.git
cd Raven
./install.sh
Run as a file, install.sh installs that checkout in editable mode: raven and
its bundled plugins link back to your tree, and the TUI bundle and the served
page are built from it. A piped run installs the published wheel even from
inside a clone, so that a one-line install never picks up whatever a working
tree happens to contain. Set RAVEN_LOCAL_SRC=<dir> to force the editable
install through a pipe.
The agent products ship with raven itself: a wheel carries the agents/
product tree and copies it out to your raven home on first use, and a source
checkout reads the tree in place. Setup asks, for each product, whether it
runs on the model it is tuned for, which needs a key of its own, or on this
raven's LLM. Nothing is registered: a folder is on the roster because it is
there. See agents/README.md.
Learn more about Raven on the documentation site.
❯❯ Core Systems
| System | What it adds |
|---|---|
| Agent Orchestration | Coordinates agents, manages task dependencies and parallel execution, and turns multi-step collaboration into reusable workflows. |
| Evolver | Drives harness self-evolution by diagnosing failures, testing candidate improvements, and retaining changes that outperform the baseline in reproducible evaluations. |
| EverOS Memory | Preserves user context, agent experience, and world knowledge across sessions, recalling relevant memories and reusable skills for future tasks. |
| SkillForge | Retrieves relevant skills from local libraries, EverOS memory, and SkillHub's catalog of 114,190 skills, giving agents specialized expertise on demand. |
| Proactivity | Combines event monitoring and scheduled execution to anticipate user needs, deliver timely reminders, and initiate follow-up work. |
❯❯ Launch WebUI
Raven's WebUI brings sessions, multi-agent collaboration, and workspace management into your browser. Chat with agents, follow task progress, inspect files and outputs, and browse memory and skills in one place.
raven web
The command opens the WebUI in your browser and keeps Raven running in the background. Use raven web --stop to stop the background service.
❯❯ EverMind Ecosystem
<p align="center"> <a href="https://github.com/user-attachments/assets/65a5e3f1-dccb-496f-94f5-9782070ec8b4"><img src="https://github.com/user-attachments/assets/65a5e3f1-dccb-496f-94f5-9782070ec8b4" alt="The EverMind ecosystem: the EverMind mark and its slogan on an orbital field" width="100%"></a> </p>EverMind connects memory research, production-ready products, and practical integrations into one open-source ecosystem.
<table> <tr> <th colspan="2">Products</th> </tr> <tr> <td><strong><a href="https://github.com/EverMind-AI/EverOS">EverOS</a></strong></td> <td>A local-first, Markdown-native long-term memory runtime for agents and users.</td> </tr> <tr> <td><strong><a href="https://github.com/EverMind-AI/Raven">Raven</a></strong></td> <td>A memory-first, self-improving agent harness with proactivity, context control, and reusable skill retrieval.</td> </tr> <tr> <td><strong><a href="https://github.com/EverMind-AI/EverMe">EverMe (CLI)</a></strong></td> <td>A CLI and agent plugin suite for cross-device, cross-agent personal memory.</td> </tr> <tr> <th colspan="2">Research & Evaluation</th> </tr> <tr> <td><strong><a href="https://github.com/EverMind-AI/SkillCorpus">SkillCorpus</a></strong></td> <td>Curated, retrieval-ready agent skill corpora with retrieval and evaluation tooling.</td> </tr> <tr> <td><strong><a href="https://github.com/EverMind-AI/EverAlgo">EverAlgo</a></strong></td> <td>Stateless extraction, ranking, parsing, and memory operators that power EverOS.</td> </tr> <tr> <td><strong><a href="https://github.com/EverMind-AI/HyperMem">HyperMem</a></strong></td> <td>Hypergraph-based hierarchical memory for coarse-to-fine long-term conversation retrieval.</td> </tr> <tr> <td><strong><a href="https://github.com/EverMind-AI/MSA">MSA</a></strong></td> <td>Memory Sparse Attention for scalable latent memory and 100M-token contexts.</td> </tr> <tr> <td><strong><a href="https://github.com/EverMind-AI/EverMemBench">EverMemBench</a></strong></td> <td>Evaluation of factual recall, applied reasoning, and personalized generalization in memory systems.</td> </tr> <tr> <td><strong><a href="https://github.com/EverMind-AI/EvoAgentBench">EvoAgentBench</a></strong></td> <td>Longitudinal evaluation of agent self-evolution, transfer efficiency, error avoidance, and skill use.</td> </tr> <tr> <th colspan="2"><a href="https://github.com/EverMind-AI/plugins">Integrations</a></th> </tr> <tr> <td><strong><a href="https://docs.openclaw.ai">OpenClaw</a></strong></td> <td><a href="https://github.com/EverMind-AI/plugins/tree/main/openclaw">OpenClaw plugin</a> for automatic recall, capture, and session-memory lifecycle management.</td> </tr> <tr> <td><strong><a href="https://github.com/NousResearch/hermes-agent">Hermes Agent</a></strong></td> <td><a href="https://github.com/EverMind-AI/plugins/tree/main/hermes">Hermes plugin</a> for persistent memory across Hermes sessions.</td> </tr> <tr> <td><strong><a href="https://github.com/deepseek-ai/DeepSeek-Harness">DeepSeek Harness</a></strong></td> <td><a href="https://github.com/EverMind-AI/plugins/tree/main/dsh">DSH plugin</a> for memory-aware DeepSeek Harness agents.</td> </tr> <tr> <td><strong><a href="https://dify.ai">Dify</a></strong></td> <td><a href="https://github.com/EverMind-AI/plugins/tree/main/dify">Self-hosted</a> and <a href="https://github.com/EverMind-AI/plugins/tree/main/dify_cloud">cloud</a> tools for explicit memory search and storage in workflows and agents.</td> </tr> </table>Together, these projects form EverMind's research-to-runtime stack: methods and benchmarks become reusable memory infrastructure, products, and agent integrations.
<br> <div align="right">❯❯ Contributing
Issues and pull requests are welcome. Start with the developer workflow, follow AGENTS.md for repository rules, and use GitHub Discussions for design conversations.
❯❯ License
❯❯ Citation
If you use Raven in your research, please cite the technical report:
@misc{evermind2026raven,
title = {{Raven: The Harness of Harnesses for Composable Agentic Intelligence}},
author = {{EverMind AI}},
year = {2026},
eprint = {2609.33439},
archivePrefix = {arXiv},
primaryClass = {cs.AI},
url = {https://arxiv.org/abs/2609.33439}
}
❯❯ Contributors
Thanks to everyone who has helped make Raven better.
<a href="https://github.com/EverMind-AI/Raven/graphs/contributors"> <img src="https://contrib.rocks/image?repo=EverMind-AI/Raven&max=500&columns=20&anon=1" alt="Raven contributors" /> </a>Raven alternatives
View more →Similar ai agents in Developer Tools, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.
| Name | Stars | Licence | Last updated | Scan |
|---|---|---|---|---|
| Raven (this page) EverMind-AI | 6k | Apache-2.0 | Nov 1, 2026 | Scanned, no flagged issues |
| Deepseek Harness deepseek-ai | 268k | MIT | Oct 30, 2026 | Scanned, no flagged issues |
| Ponytail DietrichGebert | 182k | MIT | Oct 29, 2026 | Scanned, no flagged issues |
| Orca stablyai | 112k | MIT | Nov 1, 2026 | Scanned, no flagged issues |
| Deer Flow bytedance | 85k | MIT | Nov 1, 2026 | Scanned, no flagged issues |
| Ruflo ruvnet | 80k | MIT | Nov 1, 2026 | Scanned, no flagged issues |