3条命令跑通OpenResearch：orx up研究智能体仪表盘完整走查

3条命令跑通OpenResearch：orx up研究智能体仪表盘完整走查

【免费下载链接】OpenResearchTurn your coding agents into research agents项目地址: https://gitcode.com/GitHub_Trending/op/OpenResearch

OpenResearch 是一个本地优先的研究智能体工作台：它能把 Claude Code、Codex、OpenCode、Cursor 等编码智能体升级为研究智能体，帮你查文献、提假设、跑实验、产出研究报告，全程数据留在本机。本文带你用 3 条命令装好 CLI、打开orx up研究智能体仪表盘，并完成一次完整走查，零门槛上手 autoresearch 工作流。

1️⃣ 第一条命令：安装 CLI（一键脚本）

OpenResearch 的核心是命令行工具orx，安装只需一条命令（macOS / Linux）：

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

Windows 用户处于 Beta 阶段，需先安装 Git for Windows，再下载orx.exe双击即可，详细说明见 docs/windows.md。

安装完成后，orx会出现在终端里，后续所有研究动作都可以用命令行完成。

2️⃣ 第二条命令：orx up 打开研究智能体仪表盘

orx up

这一条命令会做三件事：

• 在本机127.0.0.1:4791启动一个本地服务（绑定回环地址，默认不暴露到网络）；
• 自动打开浏览器进入研究智能体仪表盘；
• 仪表盘内可导入或新建本地项目、创建实验分支、选择 harness（智能体引擎）与模型。

orx up的实现位于 src/commands/up.rs，它内嵌了一个前端 SPA，并通过本地 SQLite 存储管理项目、会话与运行记录——这意味着创建项目和启动实验不会把你的代码发布到任何云端。

研究智能体在本地跑实验、记录训练指标后产出的缩放律分析图

💡 小贴士：再次双击或重复执行orx up不会报错，它会检测到端口被占用并直接跳转到已运行的仪表盘。

3️⃣ 第三条命令：orx login 登录账户（可选）

orx login

orx login会打开浏览器完成 OAuth 登录，并把令牌存到~/.config/openresearch/credentials.json。

• 本地项目、本地实验运行：不需要登录，前两条命令已经足够；
• OpenResearch 托管算力、实例、组织功能：需要登录；
• 不想要账号？也可以在模型选择器里接入 LM Studio、Ollama、oMLX 等本地模型（见 docs/local-models.md），全程无云账号。

🧭 仪表盘走查：项目 → 实验 → 运行 → 证据

走查按研究智能体的真实工作流展开，每一步都有对应的 CLI 命令可以对照：

实验树是 OpenResearch 的灵魂：每个研究方向都是一个独立的 Git worktree 分支，智能体在各自分支上改代码、跑实验，运行结果以不可变归档保留，形成一棵可复现的"实验谱系树"。核心规则只有一条——节点一旦有运行结果就冻结，想试新想法就向下分支出子节点，完整模型见 SKILL.md 中的 orx-experiment-tree 模块。

证据与上下文绑定：日志、diff、文件、结果、图表全部与产生它们的代码版本绑定。仓库里就内置了一份真实 demo 证据包（Apple Silicon 上跑完的 nanochat 训练实验）：

• 训练指标与评估结果：training-metrics.csv、evaluation-metrics.json
• 智能体写出的瓶颈诊断报告：nanochat-bottleneck-diagnosis.md——它综合了项目证据与 Chinchilla、LIMA 等文献，给出"预训练 token 数不足是主要瓶颈"的结论，并推荐下一轮单因子消融实验
• 证据清单：README.md

🚀 进阶：把仪表盘搬到远程 GPU 上

同一条orx up可以指向远程主机：

orx up --remote user@host

工作区跑在远端 GPU 机器上，浏览器仍在你笔记本上操作，支持 SSH config 别名与自定义端口。此外，同一份代码快照还能直接在 Slurm、Kubernetes、Ray、Hugging Face Jobs、Modal、Tinker 等后端上运行，计算后端目录由 src/jobs/ 提供。

📌 走查小结

三条命令之后，你就拥有了一个本地优先的研究智能体仪表盘：智能体自选、算力自选、数据自留。剩下的，就是把你的第一个研究问题交给它了 🎯

【免费下载链接】OpenResearchTurn your coding agents into research agents项目地址: https://gitcode.com/GitHub_Trending/op/OpenResearch