RISE-X-Lab/OpenCollab: A research-friendly, high-performance multi-agent collaboration coding framework.

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

_{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.

_{Full results}

News

• 🏆 2026-10-11 — Won first place at the OAIC Agentic Software Factory Hackathon using OpenCollab! 🏆
• 🎉 2026-10-08 — OpenCollab 0.9.3 (v1.0.0 PreRelease)

• 2026-09-29 — Our paper is on arXiv: *OpenCollab: A Multi-Agent Coding Framework with

• 2026-09-27 — OpenCollab 0.8

• 🎉 OpenCollab has been selected for support by the **Seed Program of the

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. Its Analyst entry plans and delegates to the Coder and Tester over a closed topology. 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

• Team. A YAML file declares each role's prompt, model, tools, and token

uv run opencollab team init team.yaml   # edit roles, prompts, tools, and topology
  uv run opencollab team show --team-config team.yaml
  uv run opencollab --team-config team.yaml --workspace .

• Workflow. A Python module issues every handoff. Duo is one;

Mini Edict reimplements the core protocol of Edict, a multi-agent system of roughly 24,000 lines, in 239 lines of team and workflow code.

ARC-Bench r6 is a small repo that uses the built-in Weave workflow with competition-specific format adapters. It won first place at the OAIC Agentic Software Factory Hackathon.

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:

• a message along an undeclared edge is refused, and the refusal is recorded;
• each agent's token budget is checked before every model call;
• --trace writes one JSONL record per step, stamped with the run, agent, role,

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
                   Li, Hanyu and Li, Jie and Liu, Mengyang 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