OpenCollab README

项目的 README,来自 github.com/RISE-X-Lab/OpenCollab。合并为一个 markdown 文件:README.md。

OpenCollab. Program how coding agents collaborate. Verify that they did. OpenCollab. Program how coding agents collaborate. Verify that they did.

A multi-agent coding framework with programmable collaboration and a controllable runtime.

arXiv 2609.38345 Project page Latest release License: MulanPSL-2.0 Python 3.10 through 3.14 CI
English · Chinese

OpenCollab follows a rigorous and restrained software engineering philosophy. In version 0.9.3, its harness core in the OpenCollab/opencollab directory, written in under 50,000 lines, provides comprehensive research instrumentation and statistics while outperforming Claude Code, Codex CLI and OpenHands across several coding benchmarks. The core implementations of these mature competitors have codebases spanning well over 100,000 lines. OpenCollab also won first place at the OAIC Agentic Software Factory Hackathon, which featured a $24,000 prize pool.

Pass@1 of six harnesses using GPT-5.6-Luna at max reasoning effort. OpenCollab (Duo) scores 68.91% on SWE-bench Pro, 83.15% on Terminal-Bench 2.1, and 65.49% on DeepSWE. Pass@1 of six harnesses using GPT-5.6-Luna at max reasoning effort. OpenCollab (Duo) scores 68.91% on SWE-bench Pro, 83.15% on Terminal-Bench 2.1, and 65.49% on DeepSWE.

Full results

News

Quick start

uv sync --locked
cp configs/.env.example configs/.env   # then set OPENCOLLAB_API_KEY
uv run opencollab --workspace .

configs/.env accepts any OpenAI-compatible or Anthropic endpoint. Never commit real API keys. The command starts the built-in Self-Collaboration team: the Analyst delegates to independent Coder and Tester workspaces and adopts the Coder's changes before testing. See cooperative teams for adoption, conflicts, and recovery. Custom teams choose their own tools. Type /help in the terminal for navigation, saving and exit controls. To define additional roles, create and select an explicit team file as shown below. To run Duo on a Git repository, use this command.

uv run opencollab workflow run duo --workspace /path/to/repository \
  --task 'Fix the public issue described here.' \
  --args '{"allow_unisolated_shell":true}'

Place run options such as --workspace, --model and --budget after workflow run NAME. To list workflows in another workspace, use workflow list --workspace PATH. Options placed before the workflow subcommand are interpreted as belonging to the root interactive mode and will produce a usage error.

Program the collaboration

OpenCollab Team and Workflow modes OpenCollab Team and Workflow modes

Examples

First place at the OAIC Hackathon. OpenCollab powered the first-place solution at the OAIC Agentic Software Factory Hackathon, which offered a $24,000 prize pool. Explore the winning approach in the ARC-Bench r6 example and build on it for your own applications.

From 24,000 lines to a 239-line example. Edict is a multi-agent project of roughly 24,000 lines. Mini Edict's original implementation recreates its core collaboration protocol in 239 lines of team and workflow code, showing how OpenCollab makes sophisticated multi-agent designs compact and easy to extend.

98.3% on a NeurIPS 2026 benchmark. IO2CodeBench was introduced in FromIO, accepted at NeurIPS 2026. Built on OpenCollab, this example reports a resolve rate of 98.3% (113/115), up from its 78.3% (90/115) fixed-example baseline with the same gpt-6-luna model, a 20-percentage-point gain across the benchmark's 115 non-multimodal tasks. See the results.

Verify it happened

In a Team, the agents decide the handoffs, and a declared team does not guarantee that they happen. In our runs, the lead agent often briefed its teammates and then did the work itself. OpenCollab enforces the declaration and records what each agent did:

From these records we measure Adherence, the share of runs in which the declared organization actually happened. Changing one setting of the same team raised it from 47.2% to as much as 97.2%. See how Adherence is measured.

Learn more

Guide What it covers
Package guide CLI, Python API, architecture, and runtime behavior
Configuration guide Providers, models, and team files
Duo guide Running the dual-coder workflow from the CLI and SDK
Weave guide Ordered sessions, executable checks, bounded repair and continuation
Benchmark results Tokens, cost, the paired Duo–Base test, and how to run an evaluation
Adherence What the runtime records, and how we measure Adherence
OpenCollab-Eval README Running agents on software-engineering benchmarks
Documentation index Skills, migration guides, and design records
CONTRIBUTING.md Development checks, testing, and releases

Citation

If you find OpenCollab useful, please give it a ⭐ and cite our work. Our paper is OpenCollab: A Multi-Agent Coding Framework with Programmable Collaboration and Controllable Runtime. OpenCollab builds on Self-Collaboration:

@misc{hsu2026opencollab,
  author        = {Hsu, Chun-Wah and Gong, Kai and Wu, Yu and Chen, Xianhe and
                   Liu, Mengyang and Li, Jie and Li, Hanyu and Liu, Zhixuan and
                   Tang, Naisheng and Chi, Jiaying and Fan, Ziheng and He, Xuning and
                   Yang, Xiaokang and Jiang, Xue and Dong, Yihong},
  title         = {OpenCollab: A Multi-Agent Coding Framework with Programmable Collaboration and Controllable Runtime},
  year          = {2026},
  eprint        = {2609.38345},
  archivePrefix = {arXiv},
  url           = {https://arxiv.org/abs/2609.38345}
}

@article{dong2023self,
  author        = {Dong, Yihong and Jiang, Xue and Jin, Zhi and Li, Ge},
  title         = {Self-Collaboration Code Generation via ChatGPT},
  journal       = {ACM Transactions on Software Engineering and Methodology},
  volume        = {33},
  number        = {7},
  pages         = {189:1--189:38},
  year          = {2024}
}

License

OpenCollab is licensed under the Mulan Permissive Software License v2 (MulanPSL-2.0).

Star History

OpenCollab star history chart OpenCollab star history chart

OpenCollab (RISE-X-Lab/OpenCollab)

正在搜索数据库…

这是什么?OpenCollab 是一个多智能体编程框架,多个 AI 智能体协作完成编程任务,角色可编程,运行时可控。它面向科研,内置统计功能和实验监测工具。
这是框架、库还是应用?它是一个框架:你用 YAML 文件描述智能体团队,用 Python 工作流模块编写交接逻辑,然后在终端或通过 Python API 运行。
我该怎么把它跑起来?创建 configs/.env 文件,填入 OpenAI 兼容或 Anthropic 接口的端点和密钥,然后运行 opencollab 命令。它会启动内置的 Self-Collaboration 团队,其中 Analyst 把工作分派给相互独立的 Coder 和 Tester 工作区。
我需要哪家模型服务商和哪些密钥?你需要任一 OpenAI 兼容或 Anthropic 接口的 API 密钥。密钥应放在 configs/.env 中,绝不能提交到 git。
能直接用在生产环境吗?还不行:版本 0.9.3 被标注为 v1.0.0 预发布版。作者计划在论文被接收之后才发布 1.0.0,因此请把它当作预发布版本看待。
它真的会按我声明的团队结构执行吗?会。如果消息走了未声明的连接,会被拒绝并记录日志;每次模型调用前都会检查每个智能体的 token 预算;使用 --trace 时,每一步会写入一条 JSONL 记录。
它和 Claude Code、Codex CLI 相比怎么样?作者称,其 harness 核心部分不足 50,000 行代码,在多个编程基准测试中优于 Claude Code、Codex CLI 和 OpenHands,而这些项目的核心超过 100,000 行。以上均为作者自己的说法。
它在实验室之外经过验证了吗?它赢得了 OAIC Agentic Software Factory Hackathon 的第一名,该赛事奖金池为 24,000 美元。基于它构建的一个示例报告称,在 IO2CodeBench 上的解决率为 98.3%(113/115)。
我能自己定义智能体角色吗?可以。编写一个团队 YAML 文件,声明每个角色的提示词、模型、工具和 token 配额;或者编写一个 Python 工作流模块,由你自己发起交接。
有哪些类似的项目?hive, ChatDev, GVS5H, DeLM, rrsi, Agensh, ruflo, open-multi-agent
大小
21.6 MB
星标
1.5K
时长
6个月
提交 · 90 天