OpenResearch：让多智能体并行做实验与研究
一个给 Claude Code、Codex 和 OpenCode 做并行研究的本地工作台，把实验谱系和证据一起留在 Git 里。
GitHub alphaXiv/OpenResearch 更新 2026-09-12 分支 main 星标 1.3K 分叉 94
Rust TypeScript 研究自动化 Claude Code Codex OpenCode macOS/Linux SQLite

🧭 决策指南

为什么现在热： 材料显示该仓库在 2026-09-12 的 GitHub Trending daily 榜单新增 120 星，总星数 1,277；README 同时突出 Claude Code、Codex、OpenCode 的并行研究、autoresearch、远程 GPU 和 local-first 工作区，这些主题可能共同解释了当前关注度，但材料无法进一步确认具体传播原因。

适合，如果你

  • 你要让 Claude Code、Codex 或 OpenCode 同时探索多个研究方向。
    README 的“Built for research agents”章节说明每个方向使用独立 agent session 和隔离 git worktree。
  • 你的实验需要保留提交谱系、日志、差异、结果和产物之间的关系。
    README 的“Reproducible experiments”和“Evidence in context”章节明确描述 experiment tree、immutable archive 及证据关联。
  • 你需要把同一份提交快照放到本地、SSH、Slurm、Kubernetes 或 Ray 上运行。
    README 的“Run anywhere”章节列出了这些运行环境，并说明不要求发布 repository。
  • 你希望代码和实验默认留在本机，并用本地 SQLite 保存工作区数据。
    README 的“Local by default”章节说明默认运行在 127.0.0.1，并使用 local SQLite store。

不适合，如果你

  • 你要在共享远程主机上开放服务，并要求应用层认证隔离用户。
    README 的“Run anywhere”章节明确说 remote service has no application-level authentication。
  • 你的环境是 Windows，且不能接受 beta 支持或安装 Git for Windows。
    README 的“Get started”章节说明 Windows support is still in beta，并要求 Git for Windows。
  • 你的组织禁止官方 release build 发送任何使用分析事件。
    README 的“Usage analytics”章节说明 official release builds 默认发送 opt-out、coarse usage events。
  • 你只需要单次脚本执行，不需要 Claude Code、Codex、OpenCode 的 agent session 或 experiment tree。
    README 的核心功能围绕 research agents、parallel exploration 和 reproducible experiments 展开。

前置条件

  • macOS 或 Linux 可通过 README 的安装方式安装 CLI；Windows 需要从 Releases 安装。
  • Windows 需要 Git for Windows，并应先阅读 docs/windows.md；Windows 支持仍为 beta。
  • 使用 OpenCode 连接 LM Studio、oMLX、Ollama 或 custom endpoint 时，需要参考 docs/local-models.md。
  • 远程 GPU 场景可使用 SSH；README 示例命令为 orx up --remote user@host。
  • 运行本地工作区时，README 指定默认地址为 127.0.0.1:4791，并使用 local SQLite store。

第一步命令（README 原文）

orx up

要注意

  • 执行 orx up --remote 时，远程服务绑定 loopback 但没有应用层认证。
    README 的“Run anywhere”章节明确说明其他用户可访问该远程服务。
  • 官方发布版本会发送与随机 installation ID 关联的粗粒度事件。
    README 的“Usage analytics”章节；可用 orx telemetry off 关闭。
  • 不要把 Windows beta 支持当作与 macOS/Linux 等价的稳定路径。
    README 的“Get started”章节直接标注 Windows support is still in beta。
  • 远程运行依赖 SSH 配置、主机和端口；README 只说明支持 aliases 和 custom ports。
    README 的“Run anywhere”章节。

替代方案

  • Git worktree + shell scripts：只需用 Git worktree 和脚本编排少量实验，不需要 OpenResearch 的 agent session、experiment tree 和本地 dashboard 时更直接。
    通用领域知识
  • 单独使用 Claude Code、Codex 或 OpenCode：只需要一个 coding agent 完成单条任务，不需要 OpenResearch 的并行研究和实验归档时更简单。
    README“Built for research agents”与“CLI and agent integration”章节

材料未说明

  • README 未说明 Claude Code、Codex 和 OpenCode 的具体版本兼容范围。
  • README 未说明 Rust、Node.js、Python 或其他运行时的最低版本要求。
  • README 未给出并行 agent 的数量上限、资源消耗或实验运行性能。
  • README 未说明 managed OpenResearch compute 的价格、区域、配额和数据保留期限。
  • README 未说明 127.0.0.1:4791 本地 dashboard 的具体认证机制。
  • README 未说明 Slurm、Kubernetes、Ray、Modal、Tinker 等后端的配置步骤和功能差异。
  • README 未说明 v0.2.0 相比前一版本的变更内容或升级兼容性。

💡 深度解析

6
适合 我已经使用 Claude Code、Codex 或 OpenCode，并希望让多个代理分别修改代码、运行实验和比较假设；OpenResearch 是否适合替代我目前手工管理的实验分支？
适合读者： 使用 Claude Code、Codex 或 OpenCode 进行算法实验、需要并行比较多个研究方向并保留 Git 证据链的研究工程师

适合，因为它直接把代理会话、隔离 worktree 和实验谱系组合成并行研究流程。

  • 每个研究方向都有独立代理会话和隔离 Git worktree，适合同时探索多个假设。
  • 实验树以 Git 为基础，每次运行保存所记录提交的不可变归档，便于把结果追溯到具体代码。
  • Claude Code、Codex 和 OpenCode 都是 README 明确支持的代理，且每个会话可以选择 harness 和模型。
  • 日志、差异、文件、结果和产物会绑定到产生它们的运行过程，而不是只保存最终指标。

需要注意的是，README 没有说明大规模并发上限、代理失败后的恢复策略，也没有保证代理提出的假设或实验解释正确。

  • Built for research agents："Give each research direction an independent agent session and isolated git worktree."
  • Built for research agents："Track variants in a git-native experiment tree; every run receives an immutable archive of its recorded commit."
  • Built for research agents："Use Claude Code, Codex, or OpenCode"
  • Built for research agents："Keep logs, diffs, files, results, and artifacts tied to the work that produced them."
orx install-skills
材料未说明：并行代理的最大数量、队列行为和失败重试机制未在 README 中说明。；README 未说明如何处理多个 worktree 同时修改同一文件时的合并冲突。
适合 我在本地调试模型、再把实验提交到 SSH 主机、Slurm、Kubernetes 或 Ray；OpenResearch 能否避免为每种算力环境重新复制代码和实验配置？
适合读者： 需要把同一份研究代码从本地环境迁移到 SSH 主机、Slurm、Kubernetes 或 Ray 的机器学习研究工程师

适合，前提是这些环境已经具备可用的 Git、运行时、依赖和访问配置；项目明确支持从同一提交快照切换执行位置。

  • README 列出本地、SSH、Slurm、Kubernetes、Ray、Hugging Face Jobs、Modal、Tinker 和托管算力。
  • “The same committed source snapshot”可以在这些环境运行，且不要求发布仓库。
  • orx up --remote user@host 支持在远程 GPU 主机旁运行工作区，并在本地浏览器访问。
  • 这降低了本地代码与远程实验之间的复制成本，但不会自动准备远端依赖或修复运行时差异。

远程服务绑定 loopback，却没有应用层认证；共享 SSH 主机时，同机其他用户可能访问该服务，因此不能直接当作公网安全服务使用。

  • Run anywhere："The same committed source snapshot can run locally, over SSH, or on Slurm, Kubernetes, Ray, Hugging Face Jobs, Modal, Tinker, and managed OpenResearch compute."
  • Run anywhere："Publishing the repository is not required."
  • Run anywhere："orx up --remote user@host"
  • Run anywhere："The remote service binds to loopback and has no application-level authentication"
orx up --remote user@host
材料未说明：README 未说明各后端所需的依赖、凭据、容器镜像和运行时版本。；任务取消、队列状态、失败恢复和跨后端参数映射方式未说明。
视情况 我的项目包含未发表代码和本地数据，我想用 LM Studio、oMLX、Ollama 或自定义端点运行代理；OpenResearch 是否符合本地所有权和模型可替换的要求？
适合读者： 处理未发表研究代码和本地数据、希望使用 LM Studio、oMLX、Ollama 或自定义端点且不把项目默认上传的研究人员

视情况：本地存储和本地模型连接符合要求，但只要使用外部模型、托管算力或组织服务，数据边界仍取决于具体端点和服务配置。

  • OpenResearch 默认运行在 127.0.0.1，使用本地 SQLite 保存项目、对话、实验、运行、日志、代码和产物。
  • README 明确说创建项目或启动运行不会发布代码，账号只用于组织和托管算力等服务能力。
  • OpenCode 可连接 LM Studio、oMLX、Ollama 或自定义端点，代理和模型不被固定在单一供应商。
  • 官方发布版本会发送可选择退出的粗粒度使用事件，虽不包含代码、提示词、文件内容或路径，但合规要求严格时仍需关闭。

README 没有说明每个外部模型端点的数据保留、训练使用、加密方式或代理调用时具体哪些内容会离开本机。

  • Local by default："OpenResearch runs on 127.0.0.1 with a local SQLite store."
  • Local by default："Creating a project or launching a run does not publish your code."
  • Get started："To use LM Studio, oMLX, Ollama, or a custom endpoint with OpenCode"
  • Usage analytics："Official release builds send opt-out, coarse usage events"
orx telemetry off
材料未说明：README 未说明 LM Studio、oMLX、Ollama 和自定义端点的具体 API 兼容范围。；外部模型供应商的数据保留、训练政策和请求加密方式未说明。；README 未列出代理提示词、代码片段和实验数据在不同调用路径中的传输边界。
视情况 我的工作机是 Windows，并且已经安装 Git for Windows；我希望使用 OpenResearch 的桌面应用或 CLI 管理实验，现在是否适合把它作为日常研究工作区？
适合读者： 在 Windows 上使用 Git for Windows、希望通过桌面应用或 CLI 管理研究实验的个人研究者

视情况：Windows 可以使用，但 README 明确标注仍处于 Beta，因此它更适合能接受平台兼容性风险的个人研究者，而不是要求稳定交付的工作区。

  • Windows 安装需要从 Releases 获取，并且必须先阅读 Windows notes。
  • README 明确要求 Git for Windows，这与项目依赖 Git worktree、提交和实验树的设计一致。
  • macOS/Linux 可以通过安装脚本和 orx up 启动本地 Dashboard；Windows 的启动和安装路径没有同等详细的保证。
  • 项目当前最新发布版本是 v0.2.0，公开版本数量为 5，说明仍处于较早阶段，Windows 体验可能随版本变化。

README 没有说明 Windows CLI 的完整命令覆盖、Shell 要求、路径兼容性、远程 SSH 工具链或桌面应用与 CLI 的功能差异。

  • Get started："On Windows, install from Releases and read the Windows notes first — Git for Windows is required, and support is still in beta."
  • Get started："install the CLI on macOS or Linux"
  • 项目核心数据：latest_release 为 v0.2.0，release_count 为 5
材料未说明：Windows notes 的具体限制、已知问题和支持的 Shell 未在提供的 README 片段中展开。；Windows 下桌面应用、CLI、Git worktree 和远程模式的兼容性矩阵未说明。
视情况 我希望代码、对话、实验和产物默认留在本机，但又需要使用 managed OpenResearch compute；OpenResearch 能否同时满足本地数据控制和托管算力需求？
适合读者： 需要在本地 SQLite 工作区中保存代码、对话、实验、运行日志和产物，同时使用托管 OpenResearch compute 的研究人员

视情况：项目在工作区存储层面支持本地优先，但使用托管算力时，实际发送到远端的代码、数据和日志范围需要由服务实现与配置决定。

  • OpenResearch 使用本地 SQLite 保存项目、对话、实验、运行、日志、代码和产物。
  • README 说明创建项目或启动运行不会发布代码，账号主要用于组织和 managed compute 等服务能力。
  • 执行层同时支持本地、自有基础设施和 managed OpenResearch compute，说明本地工作区与托管执行可以组合。
  • 同一 committed source snapshot 可在多种执行环境运行，不要求发布 repository，这有助于保持提交级追踪。

但 README 没有说明托管任务的数据上传范围、保存期限、加密、区域、删除机制和失败任务残留，因此不能仅凭“local-first”判断满足特定合规要求。

  • Local by default："local SQLite store" 以及保存 "projects, conversations, experiments, runs, logs, code, and artifacts"
  • Local by default："Creating a project or launching a run does not publish your code."
  • Built for research agents："Run locally, on your own infrastructure, or with managed OpenResearch compute."
  • Run anywhere："Publishing the repository is not required."
orx up
材料未说明：managed OpenResearch compute 的数据上传、缓存、日志保留、加密和删除政策未说明。；托管任务是否支持私有网络、区域选择、数据驻留和组织级访问控制未说明。；本地 SQLite 的备份、恢复、迁移和多用户并发能力未说明。
适合 我们已经用 Claude Code、Codex 或 OpenCode 写实验代码，并希望通过 CLI 同时完成论文检索、运行实验和查看日志；OpenResearch 能否覆盖这条从文献到实验的工作流？
适合读者： 需要用 CLI 处理论文检索、实验运行和日志追踪，并希望把 Claude Code、Codex 或 OpenCode 接入现有研究流程的小型机器学习团队

适合覆盖这条工作流的工程主线，但不能据 README 把它视为完整的文献管理或系统综述平台。

  • CLI 提供 orx discover keyword <query> 和 orx paper <arxiv-id-or-doi>，说明项目包含论文发现与论文入口。
  • orx projects、orx runs <project-id>、orx logs <run-id> 和 orx exp run <experiment-id> 覆盖项目、运行、日志和实验执行。
  • orx install-skills 可以把 OpenResearch 能力安装到受支持的编码代理中，适合已有 Claude Code、Codex 或 OpenCode 的团队。
  • 本地 Dashboard 通过 orx up 提供可视化工作区，CLI 则适合脚本化和远程操作。

但 README 没有确认文献元数据质量、全文获取、引用导出、系统综述流程或多人权限模型，因此这些部分不能直接视为已解决。

  • CLI and agent integration："orx projects"、"orx runs <project-id>"、"orx logs <run-id>"、"orx exp run <experiment-id>"
  • CLI and agent integration："orx discover keyword <query>"、"orx paper <arxiv-id-or-doi>"
  • CLI and agent integration："orx install-skills"
  • Get started："orx up opens the local dashboard"
orx install-skills
材料未说明：论文检索覆盖的数据源、排序质量、全文访问和引用导出能力未说明。；README 未说明多人协作、权限控制、审阅流程和 SQLite 数据库的团队并发边界。

✨ 核心亮点

  • 支持 Claude Code、Codex、OpenCode 并行探索
  • 实验树记录提交谱系并生成不可变归档
  • 可在本地、SSH、Slurm、Kubernetes 和 Ray 运行
  • Windows 支持仍处于 beta，且要求 Git for Windows

🔧 工程化

  • orx up 启动本地仪表盘，默认监听 127.0.0.1:4791
  • autoresearch 自动执行提案、改码、实验和证据检查
  • 每个研究方向使用独立 agent session 与隔离 git worktree
  • 同一提交快照可运行于本地、SSH、Slurm 和 managed compute

⚠️ 风险

  • 远程服务无应用层认证，同主机其他用户可访问
  • Windows 版本仍为 beta，并要求先阅读 docs/windows.md
  • 官方 release builds 默认发送粗粒度使用事件
  • 项目仅有 6 位贡献者、5 个版本和 10 个最近提交

👥 适合谁？

  • 需要 Claude Code、Codex 或 OpenCode 并行做研究的开发者
  • 使用本地或远程 GPU，并依赖 Slurm、Kubernetes 或 Ray 的团队
  • 希望用 SQLite 和 git 保留项目、实验、日志及产物的个人研究者