OpenResearch

项目简介

OpenResearch 是一个本地优先的研究型 AI Agent 工作区，由 alphaXiv 团队开发。它将 Claude Code、Codex、OpenCode 或 Cursor 等主流 AI 编程工具转化为能够自主完成文献综述、假设推演、实验运行和研究产出的研究 Agent。项目以 Rust 为核心，支持并行探索多条研究路线，每条路线拥有独立的 Agent 会话和隔离的 Git Worktree。

核心功能

• 并行探索：为每个研究方向启动独立的 Agent 会话，配合隔离的 Git Worktree 保证研究方向互不干扰
• 可复现实验：基于 Git 原生的实验树追踪实验变体，每次运行都会生成包含完整记录和提交快照的不可变存档
• 证据溯源：日志、差异文件、结果和产物始终与产生它们的工作内容绑定，方便回溯
• 任意模型支持：支持 Claude Code、Codex、OpenCode、Cursor，可按会话选择不同的 AI 模型和调用方式
• 多样化算力：支持本地运行、SSH 远程、Slurm、Kubernetes、Ray、Hugging Face Jobs、Modal 等多种部署方式
• 隐私优先：项目、对话、实验、代码和产物全部存储在本地，不向远程服务器同步

技术实现

OpenResearch 的核心架构围绕"实验树"和"证据上下文"两个概念展开。项目工作区以本地 SQLite 数据库为存储引擎，所有数据默认保存在用户本地磁盘。实验追踪模块基于 Git 实现，每个实验变体对应一个独立的 Worktree 分支，运行结果以归档 Commit 的形式永久保存，确保任何时候都能复现特定实验状态。Agent 调用层抽象了多种主流 AI 编程工具的接口协议，用户可以在同一套工作流中自由切换不同的 Agent 提供者。远程模式通过 SSH 隧道将本地工作区延伸到远程 GPU 集群，用户可以在笔记本上使用浏览器访问远程工作环境。技能安装模块（orx install-skills）可将 OpenResearch 能力注入支持的 AI 编程工具，使其在原有工具界面内直接调用研究工作流。

快速上手

1. 安装 CLI：在 macOS 或 Linux 上运行 curl -LsSf https://openresearch.sh/install.sh | sh，或从 Releases 页面下载 Windows 安装包
2. 启动本地仪表盘：运行 orx up，访问 http://127.0.0.1:4791 进入工作区界面
3. 创建研究项目：在仪表盘中新建项目，为每个研究方向配置独立的 Agent 类型和模型
4. 运行实验：使用 orx exp run 启动实验，系统自动创建隔离的 Git Worktree 并记录完整执行档案
5. 安装 Agent 技能：在支持 Skill 的 AI 编程工具中运行 orx install-skills，将研究能力直接集成到日常编码环境

适用人群

• 科研人员和学术工程师，需要在代码层面快速验证研究假设的群体
• AI 研究团队，希望将 AI Coding 工具整合进正式研究流程的开发者
• 独立研究员，在个人设备上运行多路线并行研究且重视数据隐私的个人研究者
• 开源社区贡献者，需要对实验变体进行精确追踪和可复现管理的项目维护者