OpenScience

The open-source AI workbench for scientific research.

Give it a goal. It reads the literature, writes and runs the code, runs the experiments, and writes up what it found, with every step on the record.

Download · Quickstart · Documentation · Changelog · Contributing

What it is

OpenScience is a research agent with a workbench around it. You describe the task in plain language; it plans, gathers evidence, runs code and experiments, and hands back results you can check. It runs as a desktop app, a browser workspace, or a terminal command, on your machine, against your files.

It is built for the parts of research that are real work but not the idea: pulling and cleaning data, reproducing a claim, sweeping a parameter, drafting the methods section, checking a reference. You keep the idea and the judgment.

• Every step is visible. A turn reads as what happened: what it thought, what it searched, what it ran, what it wrote, then the answer. Nothing runs that you cannot see afterwards.
• Real tools, real files. Shell, Python and R kernels, notebooks, a file system with explicit read and write grants, remote compute when a laptop is not enough.
• Scientific reach. Hundreds of bundled skills across biology, chemistry, physics, ML and data engineering, plus connectors to databases such as ChEMBL, UniProt, PubMed and arXiv.
• Delegation when it helps. The lead agent can hand bounded work to workers, in parallel, and keeps the synthesis and the final say.
• Your model, your terms. Bring your own API keys, sign in to a supported provider, run a local model, or use Ace, the managed pay-as-you-go option.

Install

Desktop app. Download for macOS, Windows or Linux. It updates itself.

Command line and browser workspace.

npm install -g @synsci/openscience
openscience

Or run it without installing:

npx synsci

Or with the standalone installer on macOS and Linux:

curl -fsSL https://openscience.sh/install | bash

Then open Customize → Models and connect a provider, or from the terminal:

openscience keys add        # your own API key
openscience local add       # Ollama, LM Studio, or another local endpoint

The installation guide covers platform details, updates and uninstalling.

First task

Open a project folder and describe the work:

openscience ~/research/my-project

Inspect data/samples.csv for missing values and inconsistent labels.
Keep the original data unchanged. Save a quality report and a plot
in results/, with the code needed to reproduce them.

Start with /plan when you want to agree on the method first. For a single turn from a script or a pipeline:

openscience run "Review the analysis plan in this project"
openscience run --continue "Suggest checks for the assumptions you identified"

Review sources, assumptions, code and outputs before relying on a scientific conclusion. The agent shows you what it did so that you can.

What you can do

Task	What happens
Review literature	Search scientific sources, compare findings, save cited evidence.
Analyze data	Inspect inputs, write and run analysis code, produce figures and reports.
Reproduce experiments	Agree on a claim, prerequisites and budget, then compare measured results.
Run compute	Local kernels for everyday work; Modal, SSH hosts, or Slurm and PBS clusters for GPUs and long jobs, approved before they run.
Reuse procedures	Browse the bundled skills or add a workflow specific to your lab.
Extend it	MCP servers, custom agents and commands, plugins, or the TypeScript SDK.

A skill describes a procedure; it does not mean every tool or service it references is installed. Check availability in Customize before a substantial task.

This is the beginning of the README. Read the rest at the original. Read the full README ↗