1. 项目定位与用途
OpenResearch 是本地优先的研究代理工作区，核心定位是将 Claude Code、Codex、OpenCode、Cursor 等主流编码代理转化为可自主完成研究任务的智能助手，支持并行运行多个独立的研究代理会话，覆盖文献综述、假设生成、实验执行、结果分析的全研究流程，同时提供本地 Web 仪表板与 CLI 工具，支持本地或远程计算资源上的研究自动化。
项目档案应用项目
alphaXiv/OpenResearch 是什么？用途、安装与使用指南
alphaXiv/OpenResearch：OpenResearch 是本地优先的研究代理工作区，可将 Claude Code、Codex、OpenCode、Cursor 等编码代理转化为本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
OpenResearch 是本地优先的研究代理工作区，可将 Claude Code、Codex、OpenCode、Cursor 等编码代理转化为可并行运行的研究助手，支持自动化文献综述、实验执行与可复现研究全流程管理。
中文项目介绍
OpenResearch 是面向研究场景的本地优先自动化工作区，核心定位是将 Claude Code、Codex、OpenCode、Cursor 等主流编码代理转化为具备研究能力的智能助手，支持并行运行多个研究代理，覆盖文献综述、假设生成、实验执行、结果分析的全研究流程。
它解决了传统研究流程中人工重复劳动多、实验版本混乱、并行探索效率低、可复现性差的核心痛点，通过 git-native 实验树实现实验版本的天然追踪，每个研究运行对应不可变的提交归档，保障研究过程的可追溯与可复现，同时所有项目、对话、实验、日志、代码与产物默认存储在本地，无需上传即可完成全流程操作。
适用于学术文献调研、机器学习实验探索、假设验证、分布式实验执行等场景，支持本地部署、SSH 远程及 Slurm、Kubernetes、Ray、Modal 等多类计算集群运行，提供 CLI 工具与本地 Web 仪表板，可灵活对接多种编码代理与计算资源，满足不同研究场景的自动化需求。
详细信息与使用说明
2. 解决的核心问题
它解决了传统研究流程中的多重痛点：一是文献综述、实验执行等环节人工重复劳动多、效率低；二是实验版本分散、记录混乱，可复现性差；三是多方向研究探索难以并行开展；四是研究数据与代码主权难以保障。OpenResearch 通过自动化代理能力、git-native 实验树、并行会话机制与本地优先架构，系统性解决上述问题。
3. 适用场景
适用于学术研究的自动化文献调研与假设验证、机器学习领域的并行实验探索与版本管理、需要高可复现性的研究项目管理、跨本地与远程计算资源的分布式实验执行等场景，可满足从初步研究探索到实验落地全流程的自动化需求。
4. 安装方式
macOS 与 Linux 用户可通过官方安装脚本一键安装 CLI：执行 curl -LsSf https://openresearch.sh/install.sh | sh 完成安装，随后执行 orx up 即可启动本地服务；Windows 用户需从 GitHub Releases 下载安装包，安装前需预先安装 Git for Windows，当前 Windows 支持仍处于 beta 阶段；此外还支持配置 LM Studio、Ollama 等本地推理服务与代理 harness 对接。
5. 使用方式
启动本地仪表板可执行 orx up，默认访问地址为 http://127.0.0.1:4791；执行 orx install-skills 可将 OpenResearch 研究技能安装到支持的编码代理中；常用 CLI 命令包括 orx projects 查看项目、orx runs <project-id> 查看运行记录、orx exp run <experiment-id> 执行实验、orx discover keyword <query> 检索文献、orx paper <arxiv-id-or-doi> 解析论文；支持通过 orx up --remote user@host 实现远程主机上的服务运行。
6. 实现特点与补充说明
项目采用 Rust 实现核心逻辑，支持静态 musl 构建，无外部系统依赖；本地数据默认存储在 SQLite 中，不上传代码与项目数据；实验管理基于 git worktree 实现，每个运行对应独立的 git 工作区与不可变提交归档；本地仪表板基于 axum 构建，支持 SSE 事件推送与 WebSocket 通信；官方构建的遥测数据可手动关闭，不会收集代码、提示、路径等敏感信息。
思维导图
OpenResearch
核心定位
本地优先研究工作区
编码代理研究转化
核心能力
并行研究代理会话
git 原生实验树
自动化文献综述
研究产物全链路管理
部署方式
本地部署
SSH 远程部署
计算集群（Slurm/K8s/Ray 等）
托管 OpenResearch 计算
集成生态
编码代理（Claude Code/Codex/OpenCode/Cursor）
本地模型（LM Studio/Ollama/oMLX）
远程计算后端
技术实现
Rust 核心实现
本地 SQLite 存储
axum 本地 Web 仪表板
静态 musl 无依赖构建
常见问题
OpenResearch 支持哪些编码代理？
当前支持 Claude Code、Codex、OpenCode、Cursor 四类主流编码代理，可通过 orx install-skills 命令安装 OpenResearch 专属研究技能。
OpenResearch 如何保障实验的可复现性？
基于 git worktree 实现 git-native 实验树，每个研究运行对应独立的 git 工作区与不可变提交归档，天然保障实验版本的可追溯与可复现。
是否支持本地模型运行，无需云账号？
支持，可将 LM Studio、Ollama、oMLX 等本地推理服务与 OpenCode 代理 harness 对接，无需云账号即可完成本地研究自动化。
Windows 系统是否支持 OpenResearch？
Windows 版处于 beta 阶段，需预先安装 Git for Windows，可从 GitHub Releases 下载安装包，具体注意事项可参考 docs/windows.md。