OpenResearch
本地优先的研究 agent 工作台,把 Claude Code、Codex、OpenCode 变成能查文献、提假设、跑实验并产出研究产物的自主 agent,支持多方向并行探索,并用 git 原生实验树为每次运行保留不可变快照以便复现。亮点是同一份源码快照可跑在本地、SSH、Slurm、K8s、Ray、Modal、Hugging Face Jobs 等处,项目与日志默认存在本机 SQLite,不强制发布仓库;官方构建有可关闭的匿名遥测。
README
OpenResearch
面向 research agent(研究智能体)与 autoresearch(自动研究)的本地优先工作区。
将 Claude Code、
Codex,或
OpenCode 变成能够进行文献综述、提出假设、运行实验并产出研究成果的 research agent。
快速开始
从 openresearch.sh/download 下载本地桌面应用,或在 macOS 或 Linux 上安装 CLI:
curl -LsSf https://openresearch.sh/install.sh | sh
orx up
orx up 会在 http://127.0.0.1:4791 打开本地 dashboard(控制面板)。
在 Windows 上,请从 版本发布 页面安装,并先阅读 Windows 说明 —— 需要安装 Git for Windows,且当前仍为 beta 支持。
要在 OpenCode 中使用 LM Studio、oMLX、Ollama 或自定义 endpoint(端点),请参阅 连接本地模型。
在 openresearch.sh 创建账户,即可接收邮件更新并使用托管的 OpenResearch compute(算力)。
为 research agent 而构建
| OpenResearch 为你提供 | |
|---|---|
| 并行探索 | 为每个研究方向分配独立的 agent session(会话)和隔离的 git worktree。 |
| 可复现的实验 | 在 git 原生的实验树中追踪各个 variant(变体);每次 run(运行)都会获得其所记录 commit 的不可变归档。 |
| 上下文中的证据 | 将日志、diff、文件、结果和 artifacts 与产生它们的工作绑定在一起。 |
| 自由选择 agent | 使用 Claude Code、Codex 或 OpenCode,并按 session 选择 harness 和模型。 |
| 自由选择算力 | 在本地、你自己的基础设施上,或使用托管的 OpenResearch compute 运行。 |
| 本地所有权 | 将项目、对话、实验、run、日志、代码和 artifacts 全部保存在你自己的机器上。 |
Autoresearch
OpenResearch 可以自主运行完整闭环:提出想法、修改代码、启动实验、检查证据,并决定下一步尝试什么。多个 agent 可以并行探索不同方向,而实验树会保留它们的谱系。
随处运行
同一份已提交的源码快照既可以在本地运行,也可以在 SSH、Slurm、Kubernetes、Ray、Hugging Face Jobs、Modal、Tinker 以及托管的 OpenResearch compute 上运行。无需发布仓库。
在远程 GPU 旁运行工作区,同时在笔记本浏览器中使用:
orx up --remote user@host
支持 SSH config alias(别名)和自定义端口。远程服务绑定到 loopback(回环地址),且没有应用层身份验证,因此该主机上的其他用户也可以访问它。
CLI 与 agent 集成
将 OpenResearch skill 安装到受支持的 coding agent 中:
orx install-skills
常用命令:
orx projects
orx project view <project-id>
orx runs <project-id>
orx logs <run-id>
orx exp run <experiment-id>
orx discover keyword <query>
orx paper <arxiv-id-or-doi>
运行 orx --help 或 orx <command> --help 查看完整接口。
默认本地
OpenResearch 在 127.0.0.1 上运行,并使用本地 SQLite 存储。创建项目或启动 run 不会公开你的代码。openresearch.sh 账户仅用于服务方拥有的能力,例如组织和托管算力。
使用分析
官方发布构建会发送可退出的、粗粒度的使用事件,并关联到一个随机安装 ID。这些事件不包含代码、prompt、文件内容或路径、仓库名称、token、邮箱,以及项目与实验标识符。
orx telemetry off
orx telemetry status
orx <command> --no-telemetry
源码构建和开发构建不发送分析数据。