Skip to content

Latest commit

 

History

1,328 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ScienceDiscovery

The one-stop AI research workspace, built for scientists.

Literature review, hypothesis, code, experiments and tuning — in one environment, with every step on the record.

License Release Platform Docs

Download · Quick start · Documentation · Contributing · 中文

The ScienceDiscovery workspace: project and session navigation, the composer, and the artifact, reviewer and provenance panels

Overview

ScienceDiscovery is a locally run research workspace, built on JiuwenSwarm: an agent reads the literature, writes and runs code inside a sandbox, and records the origin of every result. Everything executes on your own machine, against your own files, with your own model keys.

Installation

The prepackaged binary is the shortest path to a first run. On the Releases page, download the ScienceDiscovery-<version>-linux-x86_64 asset for x86_64 or the ScienceDiscovery-<version>-linux-aarch64 asset for arm64. Rename the downloaded file to ScienceDiscovery, then run:

chmod +x ./ScienceDiscovery
./ScienceDiscovery serve

Open the Open to sign in URL that serve prints. The browser stores the local service access token automatically, so there is nothing to copy. That token is distinct from a model API key, and the URL grants access to this machine's workspace — keep it private. The web interface is served at http://127.0.0.1:4310; the terminal window only runs the service.

For the prepackaged binary, Bubblewrap is the only system dependency. The deployment guide covers building a portable binary from source, local source mode for development, and Docker for advanced container operations. It also has first-run help for the binary and local modes. Every deployment path uses JiuwenSwarm by default; the deployment guide covers the deployment-specific operations.

Configure a model

ScienceDiscovery does not bundle a model; you connect your own API. Open System configuration at the bottom of the left sidebar, then open Model registry. Select a preset provider or add one manually, enter its details and API key, then select Save & connect. This registers the provider's models and tests the first one. When it is the first model in the system, it also becomes the default task model. If you already have models, select one from Global default task model at the top of Model registry.

Field definitions, and which of them an environment variable can set instead, are in the configuration reference.

First task

Create a Project and a Session, drop a CSV or a PDF into the workspace, and describe the analysis you want. A permission card appears before the first code execution; once approved, inspect tool calls and their results in the timeline. Generated files that the task declares as Artifacts appear in the workspace. For a step-by-step walkthrough, see the Quick Start.

Capabilities

Capability Description Reference
Literature and data access Built-in connectors reach paper and data repositories; PDFs are parsed into citable evidence Literature research · Custom MCP servers
Sandboxed code execution The agent writes, debugs and runs Python, R and shell inside a fail-closed sandbox Sandbox execution
Task decomposition Planning and multi-agent orchestration distribute a task across sub-agents and a cross-domain skill library Subagent orchestration · Skills
End-to-end provenance Code, environment, logs and cited evidence are recorded per deliverable; the optional memory graph makes the chain navigable Review and provenance · ScienceMemory

Requirements

Path System requirements
Prepackaged binary Linux x86_64/aarch64 (Windows x64 via WSL 2), Bubblewrap
Local source mode Linux (including WSL 2) or macOS; Node.js 22.19+, pnpm 11.1.2, Python 3, uv 0.9+, Git
Docker Linux containers on Linux, macOS, or Windows; Bubblewrap and unprivileged user namespaces

Managed scientific environments run on a pinned micromamba, so no system Python, R or conda is required.

Documentation

Section Guides
Getting started Quick start · Deployment
Advanced setup Custom MCP · Network proxy · ScienceMemory
Reference Configuration · REST API · Built-in tools · Runtime behavior
Developer documentation Architecture and the developer index

The complete English and Chinese indexes are in the documentation site; development setup and test commands are in CONTRIBUTING.md.

Join the community

Join the ScienceDiscovery community on Slack or Feishu to discuss your work and share feedback.

Slack Feishu
ScienceDiscovery Slack community invite QR code ScienceDiscovery Feishu community invite QR code

License

Apache License 2.0.

This product serves solely as a workflow orchestration tool and does not embed any AI model capabilities. When users integrate AI models for specific business scenarios, they shall bear full responsibility for compliance obligations under the EU AI Act and other relevant regulatory frameworks.

About

ScienceDiscovery is an all‑in‑one agentic workbench built specifically for scientific research.

Resources

Contributing

Security policy

Stars

136 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages