@researai/deepscientist 1.5.15 → 1.5.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/README.md +336 -98
  2. package/bin/ds.js +691 -91
  3. package/docs/en/00_QUICK_START.md +36 -15
  4. package/docs/en/01_SETTINGS_REFERENCE.md +33 -0
  5. package/docs/en/02_START_RESEARCH_GUIDE.md +7 -0
  6. package/docs/en/05_TUI_GUIDE.md +6 -0
  7. package/docs/en/06_RUNTIME_AND_CANVAS.md +4 -3
  8. package/docs/en/09_DOCTOR.md +11 -5
  9. package/docs/en/14_PROMPT_SKILLS_AND_MCP_GUIDE.md +63 -13
  10. package/docs/en/15_CODEX_PROVIDER_SETUP.md +25 -8
  11. package/docs/en/19_EXTERNAL_CONTROLLER_GUIDE.md +226 -0
  12. package/docs/en/19_LOCAL_BROWSER_AUTH.md +70 -0
  13. package/docs/en/20_WORKSPACE_MODES_GUIDE.md +250 -0
  14. package/docs/en/README.md +18 -0
  15. package/docs/zh/00_QUICK_START.md +36 -15
  16. package/docs/zh/01_SETTINGS_REFERENCE.md +33 -0
  17. package/docs/zh/02_START_RESEARCH_GUIDE.md +7 -0
  18. package/docs/zh/05_TUI_GUIDE.md +6 -0
  19. package/docs/zh/09_DOCTOR.md +11 -5
  20. package/docs/zh/14_PROMPT_SKILLS_AND_MCP_GUIDE.md +63 -13
  21. package/docs/zh/15_CODEX_PROVIDER_SETUP.md +25 -8
  22. package/docs/zh/19_EXTERNAL_CONTROLLER_GUIDE.md +226 -0
  23. package/docs/zh/19_LOCAL_BROWSER_AUTH.md +68 -0
  24. package/docs/zh/20_WORKSPACE_MODES_GUIDE.md +251 -0
  25. package/docs/zh/README.md +18 -0
  26. package/package.json +1 -1
  27. package/pyproject.toml +1 -1
  28. package/src/deepscientist/__init__.py +1 -1
  29. package/src/deepscientist/acp/envelope.py +6 -0
  30. package/src/deepscientist/artifact/service.py +647 -22
  31. package/src/deepscientist/bash_exec/service.py +234 -9
  32. package/src/deepscientist/cli.py +115 -19
  33. package/src/deepscientist/codex_cli_compat.py +232 -0
  34. package/src/deepscientist/config/models.py +2 -1
  35. package/src/deepscientist/config/service.py +31 -9
  36. package/src/deepscientist/daemon/api/handlers.py +125 -6
  37. package/src/deepscientist/daemon/api/router.py +4 -0
  38. package/src/deepscientist/daemon/app.py +715 -98
  39. package/src/deepscientist/gitops/__init__.py +10 -1
  40. package/src/deepscientist/gitops/diff.py +129 -0
  41. package/src/deepscientist/gitops/service.py +4 -1
  42. package/src/deepscientist/mcp/server.py +39 -0
  43. package/src/deepscientist/prompts/builder.py +255 -32
  44. package/src/deepscientist/quest/layout.py +15 -2
  45. package/src/deepscientist/quest/service.py +295 -43
  46. package/src/deepscientist/quest/stage_views.py +6 -1
  47. package/src/deepscientist/runners/codex.py +86 -31
  48. package/src/deepscientist/skills/__init__.py +2 -2
  49. package/src/deepscientist/skills/installer.py +196 -5
  50. package/src/deepscientist/skills/registry.py +66 -0
  51. package/src/prompts/connectors/qq.md +18 -8
  52. package/src/prompts/connectors/weixin.md +16 -6
  53. package/src/prompts/contracts/shared_interaction.md +12 -1
  54. package/src/prompts/system.md +10 -5
  55. package/src/prompts/system_copilot.md +43 -0
  56. package/src/skills/analysis-campaign/SKILL.md +1 -0
  57. package/src/skills/baseline/SKILL.md +8 -0
  58. package/src/skills/decision/SKILL.md +8 -0
  59. package/src/skills/experiment/SKILL.md +8 -0
  60. package/src/skills/figure-polish/SKILL.md +1 -0
  61. package/src/skills/finalize/SKILL.md +1 -0
  62. package/src/skills/idea/SKILL.md +1 -0
  63. package/src/skills/intake-audit/SKILL.md +8 -0
  64. package/src/skills/mentor/SKILL.md +217 -0
  65. package/src/skills/mentor/references/correction-rules.md +210 -0
  66. package/src/skills/mentor/references/knowledge-profile.md +91 -0
  67. package/src/skills/mentor/references/persona-profile.md +138 -0
  68. package/src/skills/mentor/references/taste-profile.md +128 -0
  69. package/src/skills/mentor/references/thought-style-profile.md +138 -0
  70. package/src/skills/mentor/references/work-profile.md +289 -0
  71. package/src/skills/mentor/references/workflow-profile.md +240 -0
  72. package/src/skills/optimize/SKILL.md +1 -0
  73. package/src/skills/rebuttal/SKILL.md +1 -0
  74. package/src/skills/review/SKILL.md +1 -0
  75. package/src/skills/scout/SKILL.md +8 -0
  76. package/src/skills/write/SKILL.md +1 -0
  77. package/src/tui/dist/app/AppContainer.js +19 -11
  78. package/src/tui/dist/index.js +4 -1
  79. package/src/tui/dist/lib/api.js +33 -3
  80. package/src/tui/package.json +1 -1
  81. package/src/ui/dist/assets/AiManusChatView-COFACy7V.js +204 -0
  82. package/src/ui/dist/assets/AnalysisPlugin-DnSm0GZn.js +1 -0
  83. package/src/ui/dist/assets/CliPlugin-CvwCmDQ5.js +109 -0
  84. package/src/ui/dist/assets/CodeEditorPlugin-cOqSa0xq.js +2 -0
  85. package/src/ui/dist/assets/CodeViewerPlugin-itb0tltR.js +270 -0
  86. package/src/ui/dist/assets/DocViewerPlugin-DqKkiCI6.js +7 -0
  87. package/src/ui/dist/assets/GitCommitViewerPlugin-DVgNHBCS.js +1 -0
  88. package/src/ui/dist/assets/GitDiffViewerPlugin-DxL2ezFG.js +6 -0
  89. package/src/ui/dist/assets/GitSnapshotViewer-B_RQm1YZ.js +30 -0
  90. package/src/ui/dist/assets/ImageViewerPlugin-tHqlXY3n.js +26 -0
  91. package/src/ui/dist/assets/LabCopilotPanel-ClMbq5Yu.js +14 -0
  92. package/src/ui/dist/assets/LabPlugin-L_SuE8ow.js +22 -0
  93. package/src/ui/dist/assets/LatexPlugin-B495DTXC.js +25 -0
  94. package/src/ui/dist/assets/MarkdownViewerPlugin-DG28-61B.js +128 -0
  95. package/src/ui/dist/assets/MarketplacePlugin-BiOGT-Kj.js +13 -0
  96. package/src/ui/dist/assets/{NotebookEditor-CccQYZjX.css → NotebookEditor-BHH8rdGj.css} +1 -1
  97. package/src/ui/dist/assets/NotebookEditor-BOr3x3Ej.css +1 -0
  98. package/src/ui/dist/assets/NotebookEditor-C-4Kt1p9.js +81 -0
  99. package/src/ui/dist/assets/NotebookEditor-CVsj8h_T.js +361 -0
  100. package/src/ui/dist/assets/PdfLoader-CASDQmxJ.js +16 -0
  101. package/src/ui/dist/assets/PdfLoader-Cy5jtWrr.css +1 -0
  102. package/src/ui/dist/assets/PdfMarkdownPlugin-BFhwoKsY.js +1 -0
  103. package/src/ui/dist/assets/PdfViewerPlugin-DcOzU9vd.js +17 -0
  104. package/src/ui/dist/assets/PdfViewerPlugin-nwwE-fjJ.css +1 -0
  105. package/src/ui/dist/assets/SearchPlugin-CHj7M58O.js +16 -0
  106. package/src/ui/dist/assets/SearchPlugin-DA4en4hK.css +1 -0
  107. package/src/ui/dist/assets/TextViewerPlugin-CB4DYfWO.js +54 -0
  108. package/src/ui/dist/assets/VNCViewer-CjlbyCB3.js +11 -0
  109. package/src/ui/dist/assets/bot-CFkZY-JP.js +6 -0
  110. package/src/ui/dist/assets/browser-CTB2jwNe.js +8 -0
  111. package/src/ui/dist/assets/chevron-up-Dq5ofbht.js +6 -0
  112. package/src/ui/dist/assets/code-DLC6G24T.js +6 -0
  113. package/src/ui/dist/assets/file-content-Dv4LoZec.js +1 -0
  114. package/src/ui/dist/assets/file-diff-panel-Denq-lC3.js +1 -0
  115. package/src/ui/dist/assets/file-jump-queue-DA-SdG__.js +1 -0
  116. package/src/ui/dist/assets/file-socket-Cu4Qln7Y.js +1 -0
  117. package/src/ui/dist/assets/git-commit-horizontal-BUh6G52n.js +6 -0
  118. package/src/ui/dist/assets/image-B9HUUddG.js +6 -0
  119. package/src/ui/dist/assets/index-B2B1sg-M.js +1 -0
  120. package/src/ui/dist/assets/index-Cgla8biy.css +33 -0
  121. package/src/ui/dist/assets/index-DRyx7vAc.js +1 -0
  122. package/src/ui/dist/assets/index-Gbl53BNp.js +2496 -0
  123. package/src/ui/dist/assets/index-wQ7RIIRd.js +11 -0
  124. package/src/ui/dist/assets/monaco-CiHMMNH_.js +1 -0
  125. package/src/ui/dist/assets/pdf-effect-queue-ZtnHFCAi.js +6 -0
  126. package/src/ui/dist/assets/plugin-monaco-C8UgLomw.js +19 -0
  127. package/src/ui/dist/assets/plugin-notebook-HbW2K-1c.js +169 -0
  128. package/src/ui/dist/assets/plugin-pdf-CR8hgQBV.js +357 -0
  129. package/src/ui/dist/assets/plugin-terminal-MXFIPun8.js +227 -0
  130. package/src/ui/dist/assets/popover-DL6h35vr.js +1 -0
  131. package/src/ui/dist/assets/project-sync-CsX08Qno.js +1 -0
  132. package/src/ui/dist/assets/select-DvmXt1yY.js +11 -0
  133. package/src/ui/dist/assets/sigma-7jpXazui.js +6 -0
  134. package/src/ui/dist/assets/trash-xA7kFt8i.js +11 -0
  135. package/src/ui/dist/assets/useCliAccess-DsMwDjOp.js +1 -0
  136. package/src/ui/dist/assets/useFileDiffOverlay-FuhcnKiw.js +1 -0
  137. package/src/ui/dist/assets/wrap-text-CwMn-iqb.js +11 -0
  138. package/src/ui/dist/assets/zoom-out-R-GWEhzS.js +11 -0
  139. package/src/ui/dist/index.html +5 -2
  140. package/src/ui/dist/assets/AiManusChatView-DDjbFnbt.js +0 -26597
  141. package/src/ui/dist/assets/AnalysisPlugin-Yb5IdmaU.js +0 -123
  142. package/src/ui/dist/assets/CliPlugin-e64sreyu.js +0 -31037
  143. package/src/ui/dist/assets/CodeEditorPlugin-C4D2TIkU.js +0 -427
  144. package/src/ui/dist/assets/CodeViewerPlugin-BVoNZIvC.js +0 -905
  145. package/src/ui/dist/assets/DocViewerPlugin-CLChbllo.js +0 -278
  146. package/src/ui/dist/assets/GitDiffViewerPlugin-C4xeFyFQ.js +0 -2661
  147. package/src/ui/dist/assets/ImageViewerPlugin-OiMUAcLi.js +0 -500
  148. package/src/ui/dist/assets/LabCopilotPanel-BjD2ThQF.js +0 -4104
  149. package/src/ui/dist/assets/LabPlugin-DQPg-NrB.js +0 -2677
  150. package/src/ui/dist/assets/LatexPlugin-CI05XAV9.js +0 -1792
  151. package/src/ui/dist/assets/MarkdownViewerPlugin-DpeBLYZf.js +0 -308
  152. package/src/ui/dist/assets/MarketplacePlugin-DolE58Q2.js +0 -413
  153. package/src/ui/dist/assets/NotebookEditor-7Qm2rSWD.js +0 -4214
  154. package/src/ui/dist/assets/NotebookEditor-C1kWaxKi.js +0 -84873
  155. package/src/ui/dist/assets/NotebookEditor-C3VQ7ylN.css +0 -1405
  156. package/src/ui/dist/assets/PdfLoader-BfOHw8Zw.js +0 -25468
  157. package/src/ui/dist/assets/PdfLoader-C-Y707R3.css +0 -49
  158. package/src/ui/dist/assets/PdfMarkdownPlugin-BulDREv1.js +0 -409
  159. package/src/ui/dist/assets/PdfViewerPlugin-C-daaOaL.js +0 -3095
  160. package/src/ui/dist/assets/PdfViewerPlugin-DQ11QcSf.css +0 -3627
  161. package/src/ui/dist/assets/SearchPlugin-CjpaiJ3A.js +0 -741
  162. package/src/ui/dist/assets/SearchPlugin-DDMrGDkh.css +0 -379
  163. package/src/ui/dist/assets/TextViewerPlugin-BxIyqPQC.js +0 -472
  164. package/src/ui/dist/assets/VNCViewer-HAg9mF7M.js +0 -18821
  165. package/src/ui/dist/assets/awareness-C0NPR2Dj.js +0 -292
  166. package/src/ui/dist/assets/bot-0DYntytV.js +0 -21
  167. package/src/ui/dist/assets/browser-BAcuE0Xj.js +0 -2895
  168. package/src/ui/dist/assets/code-B20Slj_w.js +0 -17
  169. package/src/ui/dist/assets/file-content-DT24KFma.js +0 -377
  170. package/src/ui/dist/assets/file-diff-panel-DK13YPql.js +0 -92
  171. package/src/ui/dist/assets/file-jump-queue-r5XKgJEV.js +0 -16
  172. package/src/ui/dist/assets/file-socket-B4T2o4nR.js +0 -58
  173. package/src/ui/dist/assets/function-B5QZkkHC.js +0 -1895
  174. package/src/ui/dist/assets/image-DSeR_sDS.js +0 -18
  175. package/src/ui/dist/assets/index-BrFje2Uk.js +0 -120
  176. package/src/ui/dist/assets/index-BwRJaoTl.js +0 -25
  177. package/src/ui/dist/assets/index-D_E4281X.js +0 -221322
  178. package/src/ui/dist/assets/index-DnYB3xb1.js +0 -159
  179. package/src/ui/dist/assets/index-G7AcWcMu.css +0 -12594
  180. package/src/ui/dist/assets/monaco-LExaAN3Y.js +0 -623
  181. package/src/ui/dist/assets/pdf-effect-queue-BJk5okWJ.js +0 -47
  182. package/src/ui/dist/assets/pdf_viewer-e0g1is2C.js +0 -8206
  183. package/src/ui/dist/assets/popover-D3Gg_FoV.js +0 -476
  184. package/src/ui/dist/assets/project-sync-C_ygLlVU.js +0 -297
  185. package/src/ui/dist/assets/select-CpAK6uWm.js +0 -1690
  186. package/src/ui/dist/assets/sigma-DEccaSgk.js +0 -22
  187. package/src/ui/dist/assets/square-check-big-uUfyVsbD.js +0 -17
  188. package/src/ui/dist/assets/trash-CXvwwSe8.js +0 -32
  189. package/src/ui/dist/assets/useCliAccess-Bnop4mgR.js +0 -957
  190. package/src/ui/dist/assets/useFileDiffOverlay-B8eUAX0I.js +0 -53
  191. package/src/ui/dist/assets/wrap-text-9vbOBpkW.js +0 -35
  192. package/src/ui/dist/assets/yjs-DncrqiZ8.js +0 -11243
  193. package/src/ui/dist/assets/zoom-out-BgVMmOW4.js +0 -34
package/README.md CHANGED
@@ -1,148 +1,341 @@
1
1
  <h1 align="center">
2
- <img src="assets/branding/logo.svg" alt="DeepScientist logo" width="84" />
2
+ <img src="assets/branding/logo.svg" alt="DeepScientist logo" width="92" />
3
3
  DeepScientist
4
4
  </h1>
5
5
 
6
- <p>
7
- <strong>DeepScientist is not just a long-running autonomous scientific discovery system. It is also a persistent research map that lives on your own machine.</strong>
8
- </p>
9
6
 
10
- <p>
11
- Local-first. Open-source. Git-backed. Built for verifiable computational research.
7
+ <p align="center">
8
+ DeepScientist is a local-first AI research studio, Bring your own AI scientist onto your machine in 15 minutes.
12
9
  </p>
13
10
 
11
+
12
+
14
13
  <p align="center">
15
- <a href="docs/en/README.md">English</a> | <a href="docs/zh/README.md">中文</a>
14
+ <a href="https://github.com/ResearAI/DeepScientist">GitHub</a> |
15
+ <a href="README_ZH.md">中文文档</a> |
16
+ <a href="docs/en/README.md">English Docs</a> |
17
+ <a href="https://openreview.net/forum?id=cZFgsLq8Gs">Paper</a> |
18
+ <a href="https://deepscientist.cc/">Website</a>
16
19
  </p>
17
20
 
18
21
  <p align="center">
22
+ <a href="https://github.com/ResearAI/DeepScientist"><img alt="GitHub stars" src="https://img.shields.io/github/stars/ResearAI/DeepScientist?style=for-the-badge&logo=github"></a>
19
23
  <a href="https://openreview.net/forum?id=cZFgsLq8Gs"><img alt="ICLR 2026" src="https://img.shields.io/badge/ICLR-2026-blue?style=for-the-badge&logo=openreview"></a>
20
24
  <a href="LICENSE"><img alt="License Apache-2.0" src="https://img.shields.io/badge/License-Apache%202.0-yellow.svg?style=for-the-badge"></a>
21
25
  <a href="https://www.python.org/"><img alt="Python 3.11+" src="https://img.shields.io/badge/Python-3.11%2B-blue?style=for-the-badge&logo=python&logoColor=white"></a>
22
26
  <a href="https://www.npmjs.com/package/@researai/deepscientist"><img alt="npm @researai/deepscientist" src="https://img.shields.io/badge/npm-%40researai%2Fdeepscientist-CB3837?style=for-the-badge&logo=npm&logoColor=white"></a>
23
- <a href="https://deepscientist.cc/"><img alt="Website deepscientist.cc" src="https://img.shields.io/badge/Website-deepscientist.cc-brightgreen?style=for-the-badge&logo=googlechrome&logoColor=white"></a>
27
+ </p>
28
+
29
+ <p align="center">
30
+ <strong>15-minute local setup</strong> ·
31
+ <strong>One repo per quest</strong> ·
32
+ <strong>Visible research progress</strong> ·
33
+ <strong>Human takeover anytime</strong>
24
34
  </p>
25
35
 
26
36
  <p align="center">
27
37
  <a href="docs/en/00_QUICK_START.md">Quick Start</a> •
28
- <a href="docs/en/02_START_RESEARCH_GUIDE.md">Start Research Guide</a> •
29
- <a href="docs/en/16_TELEGRAM_CONNECTOR_GUIDE.md">Telegram</a> •
30
- <a href="docs/en/17_WHATSAPP_CONNECTOR_GUIDE.md">WhatsApp</a>
31
- <a href="docs/en/18_FEISHU_CONNECTOR_GUIDE.md">Feishu</a> •
32
- <a href="docs/en/10_WEIXIN_CONNECTOR_GUIDE.md"><img src="assets/branding/connector-weixin.png" alt="Weixin" width="14" height="14" /> Weixin</a> •
33
- <a href="docs/en/03_QQ_CONNECTOR_GUIDE.md"><img src="assets/branding/connector-qq.png" alt="QQ" width="14" height="14" /> QQ</a> •
34
- <a href="docs/en/04_LINGZHU_CONNECTOR_GUIDE.md"><img src="assets/branding/connector-rokid.png" alt="Rokid" width="14" height="14" /> Rokid</a> •
35
- <a href="https://openreview.net/forum?id=cZFgsLq8Gs">Paper</a>
38
+ <a href="docs/en/02_START_RESEARCH_GUIDE.md">Launch Your First Project</a> •
39
+ <a href="docs/en/12_GUIDED_WORKFLOW_TOUR.md">Product Tour</a> •
40
+ <a href="docs/en/15_CODEX_PROVIDER_SETUP.md">Model Setup</a>
36
41
  </p>
37
42
 
43
+ ![deepscientist_install](https://github.com/user-attachments/assets/d8244944-4f70-4e08-94e3-002b74ce70fb)
44
+
45
+ If you are tired of paper overload, broken baselines, scattered experiment logs, and late-night writing cleanup, give the project a star first, then keep scrolling to see how much research grunt work it can take off your plate.
46
+
47
+ ---
48
+
49
+ https://github.com/user-attachments/assets/3c7abb44-2b25-4477-a011-10a3154d6d76
50
+
51
+ ## Still Spending Your Time On Research Grunt Work?
52
+
53
+ What drains researchers is often not the lack of ideas. It is the endless cycle of low-leverage work:
54
+
55
+ - new papers keep coming, but only a small fraction turns into an actionable next-step research plan
56
+ - baseline repos fail on environment, dependency, data, and script issues before real work even starts
57
+ - experiment results get scattered across terminals, scripts, notes, and chats, making later review painful
58
+ - writing, figures, and analysis live in separate tools, so turning them into a coherent paper takes far too long
59
+
60
+ This is the problem DeepScientist is built to solve:
61
+
62
+ > turn fragmented, repetitive, easy-to-lose research work into a local AI workspace that can keep moving, keep accumulating, and keep getting stronger over time
63
+
64
+ ## DeepScientist Is Not Just Another "Research Chatbot"
65
+
66
+ It is not a tool that summarizes papers, throws you a few ideas, and leaves the dirty work to you.
67
+
68
+ It is much closer to a real long-running AI research partner:
69
+
70
+ | What common AI tools often look like | What DeepScientist does instead |
71
+ |---|---|
72
+ | Great at chatting, but context disappears quickly | Turns tasks, files, branches, artifacts, and memory into durable state |
73
+ | Good at suggesting ideas, but weak at sustained execution | Pushes papers, baselines, experiments, and writing inside one workspace |
74
+ | Strong automation, but feels like a black box | Lets you inspect the process through the web workspace, Canvas, files, and terminal |
75
+ | Hard to take over once it goes off track | Lets you pause, take over, edit plans, change code, and continue at any time |
76
+ | Each run ends when the run ends | Preserves failed paths, winning paths, and reproduction lessons for the next round |
77
+
38
78
  ## About
39
79
 
40
- DeepScientist is not just a long-running autonomous scientific discovery system. It is also a persistent research map that lives on your own machine.
80
+ > DeepScientist is not a one-shot agent demo. It is a system built for long-horizon research work.
81
+
82
+ ## What Can It Actually Help You Get Done?
83
+
84
+ ### 1. Start a real project from a paper or a research question
85
+
86
+ - feed it a core paper, a GitHub repository, or a natural-language research objective
87
+ - it turns those inputs into an executable quest instead of a chat that loses state after a few turns
88
+
89
+ ### 2. Reproduce baselines and keep the reproduction reusable
90
+
91
+ - restore repositories, prepare environments, handle dependencies, and track the critical failures
92
+ - preserve what broke, what got fixed, and which steps are trustworthy for future rounds
93
+
94
+ ### 3. Run experiments continuously instead of stopping after one pass
95
+
96
+ - propose the next hypothesis from existing results
97
+ - branch, ablate, compare, and record conclusions
98
+ - keep failed routes as assets instead of deleting them
99
+
100
+ ### 4. Turn results into materials you can actually ship
101
+
102
+ - organize findings, conclusions, and analysis
103
+ - produce figures, reports, and paper drafts
104
+ - support local PDF and LaTeX compilation workflows
105
+
106
+ ### 5. Follow the same research effort from multiple surfaces
107
+
108
+ - the web workspace in your browser
109
+ - the TUI workflow on a remote server
110
+ - external connector surfaces for collaboration and progress updates
41
111
 
42
- - See every branch.
43
- - Recover every lesson.
44
- - Compound every round.
112
+ The current docs already cover these collaboration channels:
45
113
 
46
- **A research workspace you can actually inspect.** The frontend rebuilds a live [Canvas](docs/en/06_RUNTIME_AND_CANVAS.md) 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.
114
+ - [Weixin](docs/en/10_WEIXIN_CONNECTOR_GUIDE.md)
115
+ - [QQ](docs/en/03_QQ_CONNECTOR_GUIDE.md)
116
+ - [Telegram](docs/en/16_TELEGRAM_CONNECTOR_GUIDE.md)
117
+ - [WhatsApp](docs/en/17_WHATSAPP_CONNECTOR_GUIDE.md)
118
+ - [Feishu](docs/en/18_FEISHU_CONNECTOR_GUIDE.md)
119
+ - [Lingzhu / Rokid](docs/en/04_LINGZHU_CONNECTOR_GUIDE.md)
47
120
 
48
- **Memory that survives failure.** Built-in [memory](docs/en/07_MEMORY_AND_MCP.md) turns paper notes, dead ends, route decisions, and recovered lessons into searchable project state that later rounds can pull back deliberately.
121
+ ## Why Is It Easier To Keep Using?
49
122
 
50
- **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.
123
+ What retains users is not a flashy demo. It is a system that becomes more useful the longer you work with it.
51
124
 
52
- **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.
125
+ DeepScientist tends to stick for four reasons:
53
126
 
54
- DeepScientist is strong at:
127
+ ### Local-first by default
55
128
 
56
- - reproducing baselines and keeping them reusable
57
- - reading papers, extracting concrete limitations, and generating hypotheses
58
- - running experiment branches, analysis campaigns, figures, and paper drafts
59
- - preserving both successful and failed results so the next round can start stronger
129
+ - code, experiments, drafts, and project state stay on your own machine or server by default
130
+ - this is especially valuable for unpublished ideas, sensitive experiment history, and longer-running research loops
60
131
 
61
- DeepScientist is flexible and easy to use with:
132
+ ### One repo per quest
62
133
 
63
- - local-first, open-source, one-command install
64
- - Git-backed quest repositories, shared web workspace, Studio / Canvas, and TUI
65
- - workshop-style collaboration: let DeepScientist drive, or pause anytime to inspect, edit, and run commands yourself
66
- - Codex with `gpt-5.4` by default, plus external OpenAI-compatible inference endpoints
67
- - use DeepScientist anywhere: server via TUI, browser via Web, phone via Weixin or QQ, and even glasses via Rokid Glasses
68
- - one bound external connector per quest: [Weixin](docs/en/10_WEIXIN_CONNECTOR_GUIDE.md), [QQ](docs/en/03_QQ_CONNECTOR_GUIDE.md), Telegram, Discord, Slack, Feishu, WhatsApp, and [Lingzhu / Rokid](docs/en/04_LINGZHU_CONNECTOR_GUIDE.md)
69
- - conference-to-journal extension workflows, and rebuttal workflows from paper, code, and reviewer comments
70
- - one quest, one Git repository
71
- - branches and worktrees as native research structure
72
- - live Studio and Canvas from durable quest state
73
- - reusable baselines, not one-off benchmark runs
74
- - durable `bash_exec` sessions, not disposable terminal output
134
+ - every quest is a real Git repository
135
+ - branches, worktrees, files, and artifacts naturally express research structure
75
136
 
76
- DeepScientist works best when the task is computational, verifiable, and worth tracking across multiple rounds.
137
+ ### The process is not a black box
77
138
 
78
- ## News
139
+ - it does not only give you an output
140
+ - you can inspect what it read, what it changed, what it kept, and what it plans to do next
79
141
 
80
- - `2026/03/24`: DeepScientist officially releases `v1.5`.
81
- - `2026/02/01`: the DeepScientist paper is available on [OpenReview](https://openreview.net/forum?id=cZFgsLq8Gs) for `ICLR 2026`.
142
+ ### Human collaboration is built in
82
143
 
83
- ## Getting Started
144
+ - DeepScientist can move autonomously
145
+ - you can also step in, edit, redirect, and hand control back whenever you want
84
146
 
85
- - [Docs Index (English)](docs/en/README.md)
86
- - [Quick Start (English)](docs/en/00_QUICK_START.md)
87
- - [Guided Workflow Tour (English)](docs/en/12_GUIDED_WORKFLOW_TOUR.md)
88
- - [Start Research Guide (English)](docs/en/02_START_RESEARCH_GUIDE.md)
89
- - [Core Architecture Guide (English)](docs/en/13_CORE_ARCHITECTURE_GUIDE.md)
147
+ ## Why Try It Now?
90
148
 
91
- ## Install
149
+ Because this is not just a concept. It is a real system with public docs, a public paper, and a public install path.
150
+
151
+ - `2026/03/24`: DeepScientist officially released `v1.5`
152
+ - `2026/02/01`: the paper went live on [OpenReview](https://openreview.net/forum?id=cZFgsLq8Gs) for `ICLR 2026`
153
+ - npm install path is already available: [`@researai/deepscientist`](https://www.npmjs.com/package/@researai/deepscientist)
154
+ - both Chinese and English docs are available, along with Web, TUI, and connector entry points
155
+
156
+ ## Product Preview
157
+
158
+ ### Architecture Overview
159
+
160
+ <p align="center">
161
+ <img src="assets/readme/architecture-promo.png" alt="DeepScientist architecture overview" width="92%" />
162
+ </p>
163
+
164
+ ### Example Outputs
165
+
166
+ <table>
167
+ <tr>
168
+ <td width="50%">
169
+ <img src="assets/readme/paper-output-1.png" alt="DeepScientist generated paper example 1" width="100%" />
170
+ </td>
171
+ <td width="50%">
172
+ <img src="assets/readme/paper-output-2.png" alt="DeepScientist generated paper example 2" width="100%" />
173
+ </td>
174
+ </tr>
175
+ <tr>
176
+ <td valign="top">
177
+ <b>Example paper output 1</b><br/>
178
+ Paper-facing deliverables can be preserved directly inside the quest instead of being split across external tools.
179
+ </td>
180
+ <td valign="top">
181
+ <b>Example paper output 2</b><br/>
182
+ DeepScientist can carry work through writing, review, figure polish, and export workflows.
183
+ </td>
184
+ </tr>
185
+ </table>
186
+
187
+ ### Workspace Preview
188
+
189
+ <table>
190
+ <tr>
191
+ <td width="33%">
192
+ <img src="assets/readme/start-research-promo.png" alt="Start Research dialog" width="100%" />
193
+ </td>
194
+ <td width="33%">
195
+ <img src="assets/readme/canvas-promo.png" alt="Canvas workspace preview" width="100%" />
196
+ </td>
197
+ <td width="33%">
198
+ <img src="assets/readme/studio-details-promo.png" alt="Studio and details workspace preview" width="100%" />
199
+ </td>
200
+ </tr>
201
+ <tr>
202
+ <td valign="top">
203
+ <b>Start Research</b><br/>
204
+ Kick off a quest from a paper, repository, or natural-language goal.
205
+ </td>
206
+ <td valign="top">
207
+ <b>Canvas</b><br/>
208
+ Inspect branches, baselines, and accumulated research structure as a visible map.
209
+ </td>
210
+ <td valign="top">
211
+ <b>Studio + Details</b><br/>
212
+ Review metrics, traces, and project state without leaving the same workspace.
213
+ </td>
214
+ </tr>
215
+ </table>
216
+
217
+ ### Progress Reporting
218
+
219
+ <p align="center">
220
+ <img src="assets/readme/progress-reporting-promo.png" alt="DeepScientist progress reporting example" width="88%" />
221
+ </p>
222
+
223
+ ### Projects surface after long-running work
224
+
225
+ ![DeepScientist projects surface](assets/readme/projects-surface.png)
226
+
227
+ ## Who Will Love DeepScientist Most?
228
+
229
+ - graduate students and engineers who want to reproduce papers and push beyond existing baselines
230
+ - labs or research teams running long experiment loops, ablations, and structured result analysis
231
+ - people who want code, experiments, notes, and writing to live in one workspace
232
+ - users who do not want to hand unpublished ideas and intermediate results directly to a pure cloud workflow
233
+ - people who want to run work on servers while following progress from web, TUI, or messaging surfaces
234
+
235
+ ## The Core Philosophy Behind DeepScientist
236
+
237
+ We believe a system that is actually suitable for research should at least satisfy these principles:
238
+
239
+ - one quest, one repository, instead of letting everything dissolve after a short conversation
240
+ - branches and worktrees should express research routes naturally instead of being forced into chat history
241
+ - failed paths should be preserved, summarized, and reused instead of overwritten
242
+ - human researchers should always retain takeover power instead of being locked outside the loop
243
+ - the research process should be reviewable, inspectable, and auditable instead of relying on "the model says it did it"
244
+
245
+ If that sounds like the way you want to work, DeepScientist is worth trying now.
246
+
247
+ ## Get Started In 30 Seconds
248
+
249
+ If you want to try it right now, the shortest path is:
250
+
251
+ Platform note: DeepScientist fully supports Linux and macOS. Native Windows support is currently experimental (strongly recommend WSL2).
92
252
 
93
253
  ```bash
94
254
  npm install -g @researai/deepscientist
95
255
  codex --login
96
- ds --yolo --here
256
+ ds --here
97
257
  ```
98
258
 
99
- If `codex --login` is unavailable, run `codex` once and finish authentication there. After startup, open `http://127.0.0.1:20999`.
259
+ To stop the managed local daemon and all currently running agents:
100
260
 
101
- 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.
261
+ ```bash
262
+ ds --stop
263
+ ```
102
264
 
103
- For detailed install, troubleshooting, PDF compile, and other launch modes, use:
265
+ If `codex --login` is unavailable, run this once first:
104
266
 
105
- - [Quick Start](docs/en/00_QUICK_START.md)
106
- - [Codex Provider Setup](docs/en/15_CODEX_PROVIDER_SETUP.md)
107
- - [Doctor](docs/en/09_DOCTOR.md)
267
+ ```bash
268
+ codex
269
+ ```
108
270
 
109
- ## Documentation
271
+ If `codex` still appears to be missing after installing DeepScientist, take the explicit repair path instead of assuming the bundled dependency was linked correctly:
110
272
 
111
- - [Docs Index (English)](docs/en/README.md)
112
- - [Guided Workflow Tour (English)](docs/en/12_GUIDED_WORKFLOW_TOUR.md)
113
- - [Core Architecture Guide (English)](docs/en/13_CORE_ARCHITECTURE_GUIDE.md)
114
- - [Prompt, Skills, and MCP Guide (English)](docs/en/14_PROMPT_SKILLS_AND_MCP_GUIDE.md)
115
- - [Weixin Connector Guide (English)](docs/en/10_WEIXIN_CONNECTOR_GUIDE.md)
116
- - [Telegram Connector Guide (English)](docs/en/16_TELEGRAM_CONNECTOR_GUIDE.md)
117
- - [WhatsApp Connector Guide (English)](docs/en/17_WHATSAPP_CONNECTOR_GUIDE.md)
118
- - [Feishu Connector Guide (English)](docs/en/18_FEISHU_CONNECTOR_GUIDE.md)
119
- - [QQ Connector Guide (English)](docs/en/03_QQ_CONNECTOR_GUIDE.md)
120
- - [Lingzhu / Rokid Guide (English)](docs/en/04_LINGZHU_CONNECTOR_GUIDE.md)
121
- - [Memory and MCP Guide (English)](docs/en/07_MEMORY_AND_MCP.md)
122
- - [Settings Reference (English)](docs/en/01_SETTINGS_REFERENCE.md)
123
- - [Codex Provider Setup (English)](docs/en/15_CODEX_PROVIDER_SETUP.md)
124
-
125
- ## Maintainers
273
+ ```bash
274
+ npm install -g @openai/codex
275
+ which codex
276
+ codex --login
277
+ ```
126
278
 
127
- - [Architecture](docs/en/90_ARCHITECTURE.md)
128
- - [Development Guide](docs/en/91_DEVELOPMENT.md)
279
+ If `which codex` still prints nothing after that, fix the npm global bin path first, then retry `codex --login` and `ds doctor`.
129
280
 
130
- ## Citation
281
+ After startup, the default local address is:
131
282
 
132
- 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:
283
+ ```text
284
+ http://127.0.0.1:20999
285
+ ```
133
286
 
134
- ```bibtex
135
- @inproceedings{
136
- weng2026deepscientist,
137
- title={DeepScientist: Advancing Frontier-Pushing Scientific Findings Progressively},
138
- author={Yixuan Weng and Minjun Zhu and Qiujie Xie and QiYao Sun and Zhen Lin and Sifan Liu and Yue Zhang},
139
- booktitle={The Fourteenth International Conference on Learning Representations},
140
- year={2026},
141
- url={https://openreview.net/forum?id=cZFgsLq8Gs}
142
- }
287
+ Local browser auth is now optional and disabled by default. If you want a per-launch local access password, start with:
288
+
289
+ ```bash
290
+ ds --auth true
143
291
  ```
144
292
 
145
- ## End-to-End Autonomous Research Systems
293
+ Then you only need to do three things:
294
+
295
+ 1. click `Start Research`
296
+ 2. fill in the research goal, baseline links, paper links, or local paths
297
+ 3. let DeepScientist start a real research project that can keep evolving locally
298
+
299
+ If this is your first run, prefer an isolated environment, a non-root user, and a local machine. For the full details, see:
300
+
301
+ - [00 Quick Start](docs/en/00_QUICK_START.md)
302
+ - [15 Codex Provider Setup](docs/en/15_CODEX_PROVIDER_SETUP.md)
303
+ - [09 Doctor](docs/en/09_DOCTOR.md)
304
+
305
+ ## Choose Your Starting Path
306
+
307
+ ### I just want to get it running first
308
+
309
+ - [00 Quick Start](docs/en/00_QUICK_START.md)
310
+ - [12 Guided Workflow Tour](docs/en/12_GUIDED_WORKFLOW_TOUR.md)
311
+
312
+ ### I want to launch a real project today
313
+
314
+ - [02 Start Research Guide](docs/en/02_START_RESEARCH_GUIDE.md)
315
+ - [01 Settings Reference](docs/en/01_SETTINGS_REFERENCE.md)
316
+
317
+ ### I mainly work on servers and terminals
318
+
319
+ - [05 TUI Guide](docs/en/05_TUI_GUIDE.md)
320
+
321
+ ### I want to connect my own models or external collaboration channels
322
+
323
+ - [15 Codex Provider Setup](docs/en/15_CODEX_PROVIDER_SETUP.md)
324
+ - [Weixin Connector Guide](docs/en/10_WEIXIN_CONNECTOR_GUIDE.md)
325
+ - [QQ Connector Guide](docs/en/03_QQ_CONNECTOR_GUIDE.md)
326
+ - [Telegram Connector Guide](docs/en/16_TELEGRAM_CONNECTOR_GUIDE.md)
327
+ - [WhatsApp Connector Guide](docs/en/17_WHATSAPP_CONNECTOR_GUIDE.md)
328
+ - [Feishu Connector Guide](docs/en/18_FEISHU_CONNECTOR_GUIDE.md)
329
+
330
+ ### I want to understand the system design first
331
+
332
+ - [Docs Index](docs/en/README.md)
333
+ - [Core Architecture Guide](docs/en/13_CORE_ARCHITECTURE_GUIDE.md)
334
+ - [Prompt, Skills, and MCP Guide](docs/en/14_PROMPT_SKILLS_AND_MCP_GUIDE.md)
335
+
336
+ ## Autonomous Research Systems
337
+
338
+ ### End-to-End Autonomous Research Systems
146
339
 
147
340
  | System | System Type | E2E | Research Map | Workshop | Keeps Growing | Channels | Figure & Rebuttal & Review |
148
341
  |---|---|---|---|---|---|---|---|
@@ -161,17 +354,62 @@ url={https://openreview.net/forum?id=cZFgsLq8Gs}
161
354
  | [Research-Claw](https://github.com/wentorai/Research-Claw) | Open-source | ✓ | | ✓ | ✓ | ✓ | |
162
355
  | [DeepScientist](https://github.com/ResearAI/DeepScientist) | Open-source | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
163
356
 
357
+ ## Documentation
358
+
359
+ - [English Docs Index](docs/en/README.md)
360
+ - [Chinese Docs Index](docs/zh/README.md)
361
+
362
+ ## NLPCC 2026 AISB Challenge
363
+
364
+ If you want to benchmark or extend AI scientist systems in the wild, the NLPCC 2026 AISB shared task is a natural next stop:
365
+
366
+ - [Registration](http://tcci.ccf.org.cn/conference/2026/shared-tasks/)
367
+ - [Task Repository](https://github.com/ResearAI/NLPCC-2026-Task9-AISB)
368
+
369
+ <p align="center">
370
+ <img src="assets/readme/aisb-poster.jpeg" alt="NLPCC 2026 AISB shared task poster" width="88%" />
371
+ </p>
372
+
373
+ ## For Developers And Maintainers
374
+
375
+ If you are developing or maintaining DeepScientist, continue with:
376
+
377
+ - [Architecture](docs/en/90_ARCHITECTURE.md)
378
+ - [Development Guide](docs/en/91_DEVELOPMENT.md)
379
+ - [CONTRIBUTING](CONTRIBUTING.md)
380
+
381
+ ## Citation
382
+
383
+ If DeepScientist helps your research or engineering work, please cite:
384
+
385
+ ```bibtex
386
+ @inproceedings{
387
+ weng2026deepscientist,
388
+ title={DeepScientist: Advancing Frontier-Pushing Scientific Findings Progressively},
389
+ author={Yixuan Weng and Minjun Zhu and Qiujie Xie and QiYao Sun and Zhen Lin and Sifan Liu and Yue Zhang},
390
+ booktitle={The Fourteenth International Conference on Learning Representations},
391
+ year={2026},
392
+ url={https://openreview.net/forum?id=cZFgsLq8Gs}
393
+ }
394
+ ```
395
+
396
+ If this feels like the research workflow you have been waiting for, give the project a star. Every star makes it easier for more researchers who actually need it to find it.
397
+
398
+ ## Community
399
+
400
+ Welcome to join the WeChat group for discussion.
401
+
402
+ <p align="center">
403
+ <img src="assets/readme/wechat.jpg" alt="DeepScientist WeChat group" width="360" />
404
+ </p>
405
+
164
406
  ## More From ResearAI
165
407
 
166
- DeepReviewer and AutoFigure projects worth exploring alongside DeepScientist:
408
+ If you like DeepScientist, you may also want to explore the rest of the ResearAI ecosystem:
167
409
 
168
410
  | Project | What it does |
169
411
  |---|---|
170
- | [AutoFigure](https://github.com/ResearAI/AutoFigure) | generate paper-ready figures |
171
- | [AutoFigure-Edit](https://github.com/ResearAI/AutoFigure-Edit) | editable vector paper figures |
172
- | [DeepReviewer-v2](https://github.com/ResearAI/DeepReviewer-v2) | review papers and drafts |
412
+ | [AutoFigure](https://github.com/ResearAI/AutoFigure) | generate publication-ready figures |
413
+ | [AutoFigure-Edit](https://github.com/ResearAI/AutoFigure-Edit) | generate editable vector paper figures |
414
+ | [DeepReviewer-v2](https://github.com/ResearAI/DeepReviewer-v2) | review papers and suggest revisions |
173
415
  | [Awesome-AI-Scientist](https://github.com/ResearAI/Awesome-AI-Scientist) | curated AI scientist landscape |
174
-
175
- ## License
176
-
177
- [Apache License 2.0](LICENSE)