RISE-X-Lab/OpenCollab

OpenCollab – 多代理编码框架

它是什么 – OpenCollab 是一个基于 Python 的研究框架，让您可以定义一个编码代理团队（例如分析师、编码员、测试员）以及一个协调这些代理如何相互交接工作的工作流程。运行时会强制执行声明的协作拓扑，记录每一步，并测量代理是否确实遵循了计划（论文中称之为依从性）。

为什么重要 – 现代代码生成模型（Claude Code、Codex、OpenHands 等）通常作为单一整体代理运行。OpenCollab 显示，一个小型、精心设计的多代理系统（≈ 50k 行代码）可以在标准软件工程基准测试（如 SWE-bench Pro、Terminal-Bench 2.1 和 DeepSWE）上超越那些较大的代码库，同时为研究人员提供关于 Token 使用量、成本以及对预设协作图合规性的细粒度统计数据。

主要功能

• 团队定义 – YAML 文件描述每个角色的提示词、模型、工具、Token 预算以及谁可以发送消息给谁。
• 可编程工作流程 – 内置“Duo”（双编码员）和“Weave”（有序会话）工作流程；用户可以编写自定义的 Python 工作流程模块。
• 可控运行时 – 强制执行声明的消息边缘，在每次模型调用前检查 Token 预算，并可输出整个运行的 JSONL 追踪文件。
• 依从性指标 – 记录拒绝情况并测量遵守声明拓扑的运行百分比（报告最高达 97%）。
• CLI 与 SDK – uv run opencollab … 用于快速实验；提供 Python API 用于更深度的集成。
• 基准测试套件 – 结果页面记录了 Token 成本权衡以及与 Claude Code、Codex CLI 和 OpenHands 的比较分数。

入门指南

uv sync --locked                     # 安装锁定的依赖项
cp configs/.env.example configs/.env # 加入您的 OpenAI/Anthropic 密钥
uv run opencollab --workspace .      # 启动默认的自我协作团队

您可以接着编辑提供的 team.yaml 或编写新的工作流程，例如：

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

文档与资源 – 仓库附带完整的包指南、配置指南、工作流程教程（Duo、Weave）、基准测试结果，以及一个用于在大型软件工程数据集上运行的独立评估仓库（OpenCollab-Eval）。

状态 – 最新的预发布版本为 v0.9.3 (2026 年 10 月)。作者计划在他们的 arXiv 论文被接受后发布 1.0.0 版本。该项目已赢得 OAIC Agentic Software Factory 黑客松，并获得青年开源基金支持。

授权 – Mulan Permissive Software License v2 (MulanPSL-2.0)。