ScienceDiscovery
English GitHub

安装 ScienceDiscovery

选择你的系统，再跳转到适合的安装方式。

预编译单文件二进制 原生 Linux 推荐适用于使用 glibc 的 Linux x86_64 与 aarch64，包括 Windows 上符合条件的 WSL 2 Linux 发行版。每种架构一个可执行文件，内含 Node、Python、Web 界面与 micromamba。Linux 环境仍需 Bubblewrap 与非特权用户命名空间。macOS 可考虑下方的本地源码模式或 Docker 路径。
系统使用 glibc 的 Linux x86_64 或 aarch64，包括 WSL 2；需 glibc 2.28+ 和兼容的 libstdc++（不适用于 Alpine/musl）
LINUX 依赖bubblewrap 0.6+（需非特权用户命名空间）；Debian 11 默认软件包版本较低
网络首次启动会从 PyPI 镜像安装 uv 与 Python 依赖
下载 Linux x86_64
SHA256348fbf2aeb2d38062ccbf4b2bdf0bfd99517eba0cc48370d9351b7482f758bb6
下载 Linux aarch64
SHA2561b8b64335a9846721c9bf39448c07f4265d373ce4e4bc088b9149107b66576b3
  1. 按自己的 Linux 发行版安装 Bubblewrap，两条命令只需执行其一。

    Debian / Ubuntu

    sudo apt-get install -y bubblewrap

    Fedora / RHEL / openEuler

    sudo dnf install -y bubblewrap
  2. 下载对应架构的二进制，执行下方与文件匹配的命令。Windows 用户先打开 WSL 2 的 Linux 终端（例如 Ubuntu），在其中运行 cd ~ && explorer.exe .。Windows 文件资源管理器会打开 Linux 用户主目录，先将下载文件复制进去。

    x86_64

    mv ScienceDiscovery-0.2.0-linux-x86_64 ScienceDiscovery
chmod +x ./ScienceDiscovery

    aarch64

    mv ScienceDiscovery-0.2.0-linux-aarch64 ScienceDiscovery
chmod +x ./ScienceDiscovery
  3. 启动服务，并保持当前终端开启。
    ./ScienceDiscovery serve
  4. 在同一 Linux 环境中另开终端检查服务响应，顶层 status 应为 ok。
    curl -fsS http://127.0.0.1:4310/health
完整指南中的二进制部署 →
Docker Compose在 Linux 容器中运行完整服务栈。
操作系统Linux；macOS 使用 Docker Desktop（核对系统要求）或可用的 Docker 引擎；Windows 使用 Docker Desktop
软件Docker Engine 24+ 与 Compose v2.15+，或 Docker Desktop。Windows 用户请选择 Linux 容器。
沙箱Linux 容器内需允许 Bubblewrap 使用非特权用户命名空间
  1. 克隆仓库并进入仓库目录。
    git clone https://github.com/openJiuwen-ai/sciencediscovery.git
cd sciencediscovery
  2. 准备 .env 和 data/。Linux / macOS 用户若 uid/gid 不为 1000，需在 .env 中设置 SCIENCE_AGENT_UID 和 SCIENCE_AGENT_GID；Windows 用户先使用默认值，若 data/ 不可写，请查看下方排障指南。

    Linux / macOS · Unix Shell

    cp .env.docker.example .env
mkdir -p data
id -u
id -g

    Windows · PowerShell

    Copy-Item .env.docker.example .env
New-Item -ItemType Directory -Force data
  3. 构建并启动。
    docker compose build
docker compose up -d
  4. 检查服务响应，从日志中找到“Open to sign in”链接。
    docker compose ps
docker compose exec sciencediscovery curl -fsS http://127.0.0.1:4310/health
docker compose logs --tail=100 sciencediscovery
完整 Docker 部署与排障指南 →
本地源码模式直接从源码仓库启动服务，适合在 Linux 或 macOS 13+ 上开发与调试。Windows 可在 WSL 2 中运行 Linux 步骤。
工具链Node.js 22.19+、pnpm 11.1.2、python3 3.9+、uv 0.9+、Git、curl
LINUX / WSL 2 沙箱Bubblewrap 0.6+（建议 0.8+），需非特权用户命名空间；Debian 11 默认软件包版本较低
MACOS13+，使用系统自带 Seatbelt（/usr/bin/sandbox-exec）
  1. 克隆仓库。Windows 用户请先在 WSL 2 内运行 cd ~，再执行这些 Linux 命令，不要将仓库放在 /mnt/c。
    git clone https://github.com/openJiuwen-ai/sciencediscovery.git
cd sciencediscovery
  2. 首次运行前安装 JiuwenSwarm。
    scripts/jiuwenswarm.sh setup
  3. 安装、构建并启动全部服务，保持当前终端开启。
    ./scripts/start-stack.sh --mode local
  4. 之后启动时可用此命令跳过构建。
    ./scripts/start-stack.sh --mode local --no-build
完整指南中的本地模式 →

启动之后

登录

打开启动输出中的“Open to sign in”链接，浏览器会自动保存本地服务令牌。请勿泄露该链接。

配置模型

打开“系统设置 → 模型注册表”，连接模型服务商，再选择全局默认任务模型。ScienceDiscovery 本身不内置任何模型。

运行第一个任务

运行一个实际执行代码的任务，再检查其结果。快速开始提供了 Python 示例和检查清单。

默认端口

4310控制 API 与 Web 界面
4311Runner（仅回环地址）

阅读完整部署指南 在 GitHub 查看全部版本 →