📌 项目地址:alphaXiv/OpenResearch | ⭐ 1,171 颗星 | 🔧 Rust | 📜 未标注

项目地址:alphaXiv/OpenResearch | Rust | 1171 stars

先说这个项目是什么

alphaXiv 开源了 OpenResearch,一个本地优先的研究代理工作区。用途一句话说清:把 Claude Code、Codex、OpenCode、Cursor 这些编码代理变成研究代理——查文献、提假设、跑实验、产出研究产物。

但我觉得它真正的价值在另一处:实验证据管理。

AI 跑实验的真正痛点

用 AI 跑过实验的人大概都碰到过这种情况:十几轮运行之后,哪次改了什么代码、产出了什么结果、日志在哪个目录,全靠记忆和文件名约定撑着。代理跑得越自主,这个问题越严重——它一晚上替你做了几十次决策,你却没法回溯其中任何一次的依据。

OpenResearch 的解法有两层:

  • 每个研究方向一个独立代理会话,配一个隔离的 git worktree,方向之间互不污染
  • 所有实验变体记录在一棵 git 原生的实验树里;每次运行生成对应提交的不可变归档,日志、diff、文件、结果、产物全部绑定到产生它们的那次工作

第二点是关键。跑坏了能查到当时代理看到了什么、改了什么,这比“跑得快”重要得多。

Autoresearch:整个循环交给代理

OpenResearch 支持自主跑完整循环:提出想法 → 改代码 → 启动实验 → 检查证据 → 决定下一步。多个代理可以并行探索不同方向,实验树负责记录各自的谱系。

这套设计的前提就是上面的归档机制——代理连续做决策,出错时你得有证据链可查。

安装和基本用法

桌面应用从 openresearch.sh/download 下载。macOS/Linux 装 CLI:

curl -LsSf https://openresearch.sh/install.sh | sh
orx up

orx up 会在 http://127.0.0.1:4791 打开本地面板。

Windows 用户注意:需要从 Releases 下载,先装 Git for Windows,支持还是 beta。

想接本地模型(LM Studio、oMLX、Ollama,或自定义 endpoint 配 OpenCode),看仓库里的 docs/local-models.md。

远程模式:工作区在 GPU 机器,浏览器在笔记本

同一份提交的源码快照可以跑在本地、SSH、Slurm、Kubernetes、Ray、Hugging Face Jobs、Modal、Tinker,或者托管的 OpenResearch 算力上。不要求发布仓库。

典型用法:

orx up --remote user@host

支持 SSH config 别名和自定义端口。

一个必须知道的限制:远程服务只绑定 loopback,没有应用层认证。README 自己写明了,同主机上的其他用户可以访问它。在共享的多用户服务器上用之前,先掂量一下。

和编码代理的集成

orx install-skills

这条命令把 OpenResearch 的技能装进支持的编码代理。常用命令:

orx projects
orx project view
orx runs
orx logs
orx exp run
orx discover keyword

README 只列了命令名,参数细节看官方文档。

几个事实

数据全留本机:项目、对话、实验、运行、日志、代码、产物都在你的机器上。在 openresearch.sh 注册账号只是为了收邮件更新和用托管算力。

代理和模型按会话指定,Claude Code、Codex、OpenCode、Cursor 可以混着用。

1171 stars,Rust 写的,早期阶段,Windows 不稳定。

我的判断

如果你只需要 AI 帮忙写段分析代码,这个项目是杀鸡用牛刀。但如果你在做需要并行探索多个方向的研究——每次实验的代码变更和产出都要留痕、要能回溯——实验树加不可变归档这套设计,恰好是直接在终端里跑 Claude Code 做不到的部分。

这篇文章对你有帮助吗?

发表回复