@researai/deepscientist
v1.5.15
Published
DeepScientist is not just a fully open-source autonomous scientific discovery system. It is also a research map that keeps growing from every round.
Downloads
1,831
Readme
About
DeepScientist is not just a long-running autonomous scientific discovery system. It is also a persistent research map that lives on your own machine.
- See every branch.
- Recover every lesson.
- Compound every round.
A research workspace you can actually inspect. The frontend rebuilds a live Canvas from Git branches, artifacts, connector traffic, and raw quest events, so progress stays visible as a navigable map instead of collapsing into one long chat log.
Memory that survives failure. Built-in memory turns paper notes, dead ends, route decisions, and recovered lessons into searchable project state that later rounds can pull back deliberately.
A self-evolving loop with real state. Failed branches, reusable baselines, promoted lessons, and new evidence all feed the next round, so DeepScientist compounds research progress instead of restarting from zero.
A studio, not a sealed autopilot. DeepScientist can drive a task end to end, but you can step in at any moment to redirect the plan, edit code, inspect files, or run the terminal yourself inside the same quest.
DeepScientist is strong at:
- reproducing baselines and keeping them reusable
- reading papers, extracting concrete limitations, and generating hypotheses
- running experiment branches, analysis campaigns, figures, and paper drafts
- preserving both successful and failed results so the next round can start stronger
DeepScientist is flexible and easy to use with:
- local-first, open-source, one-command install
- Git-backed quest repositories, shared web workspace, Studio / Canvas, and TUI
- workshop-style collaboration: let DeepScientist drive, or pause anytime to inspect, edit, and run commands yourself
- Codex with
gpt-5.4by default, plus external OpenAI-compatible inference endpoints - use DeepScientist anywhere: server via TUI, browser via Web, phone via Weixin or QQ, and even glasses via Rokid Glasses
- one bound external connector per quest: Weixin, QQ, Telegram, Discord, Slack, Feishu, WhatsApp, and Lingzhu / Rokid
- conference-to-journal extension workflows, and rebuttal workflows from paper, code, and reviewer comments
- one quest, one Git repository
- branches and worktrees as native research structure
- live Studio and Canvas from durable quest state
- reusable baselines, not one-off benchmark runs
- durable
bash_execsessions, not disposable terminal output
DeepScientist works best when the task is computational, verifiable, and worth tracking across multiple rounds.
News
2026/03/24: DeepScientist officially releasesv1.5.2026/02/01: the DeepScientist paper is available on OpenReview forICLR 2026.
Getting Started
- Docs Index (English)
- Quick Start (English)
- Guided Workflow Tour (English)
- Start Research Guide (English)
- Core Architecture Guide (English)
Install
npm install -g @researai/deepscientist
codex --login
ds --yolo --hereIf codex --login is unavailable, run codex once and finish authentication there. After startup, open http://127.0.0.1:20999.
Linux and macOS remain the most battle-tested platforms. Native Windows support is now experimental; if you need the closest Linux-like terminal behavior, prefer WSL2.
For detailed install, troubleshooting, PDF compile, and other launch modes, use:
Documentation
- Docs Index (English)
- Guided Workflow Tour (English)
- Core Architecture Guide (English)
- Prompt, Skills, and MCP Guide (English)
- Weixin Connector Guide (English)
- Telegram Connector Guide (English)
- WhatsApp Connector Guide (English)
- Feishu Connector Guide (English)
- QQ Connector Guide (English)
- Lingzhu / Rokid Guide (English)
- Memory and MCP Guide (English)
- Settings Reference (English)
- Codex Provider Setup (English)
Maintainers
Citation
This project is currently contributed by Yixuan Weng, Shichen Li, Weixu Zhao, Qiyao Sun, Zhen Lin, Minjun Zhu. If you find our work valuable, please cite:
@inproceedings{
weng2026deepscientist,
title={DeepScientist: Advancing Frontier-Pushing Scientific Findings Progressively},
author={Yixuan Weng and Minjun Zhu and Qiujie Xie and QiYao Sun and Zhen Lin and Sifan Liu and Yue Zhang},
booktitle={The Fourteenth International Conference on Learning Representations},
year={2026},
url={https://openreview.net/forum?id=cZFgsLq8Gs}
}End-to-End Autonomous Research Systems
| System | System Type | E2E | Research Map | Workshop | Keeps Growing | Channels | Figure & Rebuttal & Review | |---|---|---|---|---|---|---|---| | autoresearch | Open-source | | | ✓ | | | | | RD-Agent | Open-source | | | | ✓ | | | | Agent Laboratory | Open-source | ✓ | | ✓ | ✓ | | | | AI-Scientist | Open-source | ✓ | | | | | | | AI-Scientist-v2 | Open-source | ✓ | | | | | | | AutoResearchClaw | Open-source | ✓ | | | ✓ | ✓ | | | ClawPhD | Open-source | | | ✓ | | ✓ | | | Dr. Claw | Open-source | ✓ | | ✓ | | ✓ | | | FARS | Closed-source | ✓ | | | | | | | EvoScientist | Open-source | ✓ | | ✓ | ✓ | ✓ | | | ScienceClaw | Open-source | | | | ✓ | ✓ | | | claude-scholar | Open-source | ✓ | | ✓ | ✓ | | | | Research-Claw | Open-source | ✓ | | ✓ | ✓ | ✓ | | | DeepScientist | Open-source | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
More From ResearAI
DeepReviewer and AutoFigure projects worth exploring alongside DeepScientist:
| Project | What it does | |---|---| | AutoFigure | generate paper-ready figures | | AutoFigure-Edit | editable vector paper figures | | DeepReviewer-v2 | review papers and drafts | | Awesome-AI-Scientist | curated AI scientist landscape |
