open-science

环境要求

• 桌面操作系统（README 提供各平台安装包，如 macOS）
• 可访问网络，用于环境检查、运行时下载与模型连接测试
• 任一受支持的模型提供方账号与 API Key，或已有的 Claude / Codex 订阅登录
• 可选：Python 或 R 环境，用于 Notebook 执行（可由应用托管）

安装与启动步骤

1. 1下载安装包

   从 GitHub Releases 页面（releases/latest）下载与你的操作系统匹配的安装包并完成安装，无需预先准备运行环境。

2. 2首次启动向导

   首次启动进入五步引导，先完成 Environment 检查：主机兼容性、应用存储、凭据安全存储与网络访问。

3. 3选择数据目录

   在 Data location 步骤指定大型产物、Notebook、上传文件与环境文件的存放位置，可先沿用默认值。

4. 4准备 Agent 运行时

   在 Agent runtime 步骤选择 Claude Code、OpenCode、Codex 或 CodeBuddy；应用托管运行时无需 Node.js、npm 或管理员密码。

5. 5连接模型提供方

   在 Model provider 步骤选择内置提供方、自定义网关，或使用已有 Claude / Codex 订阅登录，并通过连接测试。

6. 6配置 Notebook 运行时

   可选的 Notebook runtime 步骤，可准备应用托管的 Python 与 R 环境，或启用已检测与手动注册的解释器。

7. 7创建项目跑任务

   完成后创建或打开项目、开启会话；也可用官方 CLI 按项目名创建项目并按任务文件运行任务。

   open-science project create "Systematic review"
   open-science run --project "Systematic review" \
     --prompt-file ./task.md \
     --approval-profile auto \
     --skill literature-review \
     --wait --json

   复制

关键配置

如何确认成功

引导中环境检查与 Agent 运行时检查全部通过、模型连接测试成功、Continue 可点击并可完成设置，即表示就绪。

常见问题

注意事项

• 本项目为本地优先、模型无关的桌面工作台，数据默认保存在本机，请自行备份所选数据目录。
• Agent 运行时与模型提供方可在设置中更换，更换后需重新通过连接测试。
• 数据位置与 Notebook 运行时在引导中可保持默认，之后可在 Settings 中随时修改。
• README 未给出 CLI 的单独安装方式，上述 CLI 命令以其文档给出的形式为准。