@researai/deepscientist 1.5.16 → 1.5.17

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 (82) hide show
  1. package/README.md +66 -23
  2. package/bin/ds.js +550 -19
  3. package/docs/en/00_QUICK_START.md +65 -5
  4. package/docs/en/01_SETTINGS_REFERENCE.md +1 -1
  5. package/docs/en/09_DOCTOR.md +14 -3
  6. package/docs/en/15_CODEX_PROVIDER_SETUP.md +12 -3
  7. package/docs/en/21_LOCAL_MODEL_BACKENDS_GUIDE.md +283 -0
  8. package/docs/en/91_DEVELOPMENT.md +237 -0
  9. package/docs/en/README.md +7 -3
  10. package/docs/zh/00_QUICK_START.md +54 -5
  11. package/docs/zh/01_SETTINGS_REFERENCE.md +1 -1
  12. package/docs/zh/09_DOCTOR.md +15 -4
  13. package/docs/zh/15_CODEX_PROVIDER_SETUP.md +12 -3
  14. package/docs/zh/21_LOCAL_MODEL_BACKENDS_GUIDE.md +281 -0
  15. package/docs/zh/README.md +7 -3
  16. package/install.sh +46 -4
  17. package/package.json +2 -1
  18. package/pyproject.toml +1 -1
  19. package/src/deepscientist/__init__.py +1 -1
  20. package/src/deepscientist/bridges/connectors.py +8 -2
  21. package/src/deepscientist/codex_cli_compat.py +185 -72
  22. package/src/deepscientist/config/service.py +154 -6
  23. package/src/deepscientist/daemon/api/handlers.py +130 -25
  24. package/src/deepscientist/daemon/api/router.py +5 -0
  25. package/src/deepscientist/daemon/app.py +446 -22
  26. package/src/deepscientist/diagnostics/__init__.py +6 -0
  27. package/src/deepscientist/diagnostics/runner_failures.py +130 -0
  28. package/src/deepscientist/doctor.py +207 -3
  29. package/src/deepscientist/prompts/builder.py +22 -4
  30. package/src/deepscientist/quest/service.py +413 -13
  31. package/src/deepscientist/runners/codex.py +59 -14
  32. package/src/deepscientist/shared.py +19 -0
  33. package/src/prompts/contracts/shared_interaction.md +3 -2
  34. package/src/prompts/system.md +13 -0
  35. package/src/prompts/system_copilot.md +13 -0
  36. package/src/tui/package.json +1 -1
  37. package/src/ui/dist/assets/{AiManusChatView-COFACy7V.js → AiManusChatView-Bv-Z8YpU.js} +44 -44
  38. package/src/ui/dist/assets/{AnalysisPlugin-DnSm0GZn.js → AnalysisPlugin-BCKAfjba.js} +1 -1
  39. package/src/ui/dist/assets/{CliPlugin-CvwCmDQ5.js → CliPlugin-BCKcpc35.js} +4 -4
  40. package/src/ui/dist/assets/{CodeEditorPlugin-cOqSa0xq.js → CodeEditorPlugin-DbOfSJ8K.js} +1 -1
  41. package/src/ui/dist/assets/{CodeViewerPlugin-itb0tltR.js → CodeViewerPlugin-CbaFRrUU.js} +3 -3
  42. package/src/ui/dist/assets/{DocViewerPlugin-DqKkiCI6.js → DocViewerPlugin-DAjLVeQD.js} +3 -3
  43. package/src/ui/dist/assets/{GitCommitViewerPlugin-DVgNHBCS.js → GitCommitViewerPlugin-CIUqbUDO.js} +1 -1
  44. package/src/ui/dist/assets/{GitDiffViewerPlugin-DxL2ezFG.js → GitDiffViewerPlugin-CQACjoAA.js} +1 -1
  45. package/src/ui/dist/assets/{GitSnapshotViewer-B_RQm1YZ.js → GitSnapshotViewer-0r4nLPke.js} +1 -1
  46. package/src/ui/dist/assets/{ImageViewerPlugin-tHqlXY3n.js → ImageViewerPlugin-nBOmI2v_.js} +3 -3
  47. package/src/ui/dist/assets/{LabCopilotPanel-ClMbq5Yu.js → LabCopilotPanel-BHxOxF4z.js} +1 -1
  48. package/src/ui/dist/assets/{LabPlugin-L_SuE8ow.js → LabPlugin-BKoZGs95.js} +1 -1
  49. package/src/ui/dist/assets/{LatexPlugin-B495DTXC.js → LatexPlugin-ZwtV8pIp.js} +1 -1
  50. package/src/ui/dist/assets/{MarkdownViewerPlugin-DG28-61B.js → MarkdownViewerPlugin-DKqVfKyW.js} +3 -3
  51. package/src/ui/dist/assets/{MarketplacePlugin-BiOGT-Kj.js → MarketplacePlugin-BwxStZ9D.js} +1 -1
  52. package/src/ui/dist/assets/{NotebookEditor-C-4Kt1p9.js → NotebookEditor-BEQhaQbt.js} +1 -1
  53. package/src/ui/dist/assets/{NotebookEditor-CVsj8h_T.js → NotebookEditor-DB9N_T9q.js} +23 -23
  54. package/src/ui/dist/assets/{PdfLoader-CASDQmxJ.js → PdfLoader-eWBONbQP.js} +1 -1
  55. package/src/ui/dist/assets/{PdfMarkdownPlugin-BFhwoKsY.js → PdfMarkdownPlugin-D22YOZL3.js} +1 -1
  56. package/src/ui/dist/assets/{PdfViewerPlugin-DcOzU9vd.js → PdfViewerPlugin-c-RK9DLM.js} +3 -3
  57. package/src/ui/dist/assets/{SearchPlugin-CHj7M58O.js → SearchPlugin-CxF9ytAx.js} +1 -1
  58. package/src/ui/dist/assets/{TextViewerPlugin-CB4DYfWO.js → TextViewerPlugin-C5xqeeUH.js} +2 -2
  59. package/src/ui/dist/assets/{VNCViewer-CjlbyCB3.js → VNCViewer-BoLGLnHz.js} +1 -1
  60. package/src/ui/dist/assets/{bot-CFkZY-JP.js → bot-DREQOxzP.js} +1 -1
  61. package/src/ui/dist/assets/{chevron-up-Dq5ofbht.js → chevron-up-C9Qpx4DE.js} +1 -1
  62. package/src/ui/dist/assets/{code-DLC6G24T.js → code-WlFHE7z_.js} +1 -1
  63. package/src/ui/dist/assets/{file-content-Dv4LoZec.js → file-content-BZMz3RYp.js} +1 -1
  64. package/src/ui/dist/assets/{file-diff-panel-Denq-lC3.js → file-diff-panel-CQhw0jS2.js} +1 -1
  65. package/src/ui/dist/assets/{file-socket-Cu4Qln7Y.js → file-socket-CfQPKQKj.js} +1 -1
  66. package/src/ui/dist/assets/{git-commit-horizontal-BUh6G52n.js → git-commit-horizontal-DxZ8DCZh.js} +1 -1
  67. package/src/ui/dist/assets/{image-B9HUUddG.js → image-Bgl4VIyx.js} +1 -1
  68. package/src/ui/dist/assets/{index-Cgla8biy.css → index-BpV6lusQ.css} +1 -1
  69. package/src/ui/dist/assets/{index-Gbl53BNp.js → index-CBNVuWcP.js} +363 -363
  70. package/src/ui/dist/assets/{index-wQ7RIIRd.js → index-CwNu1aH4.js} +1 -1
  71. package/src/ui/dist/assets/{index-B2B1sg-M.js → index-DrUnlf6K.js} +1 -1
  72. package/src/ui/dist/assets/{index-DRyx7vAc.js → index-NW-h8VzN.js} +1 -1
  73. package/src/ui/dist/assets/{pdf-effect-queue-ZtnHFCAi.js → pdf-effect-queue-J8OnM0jE.js} +1 -1
  74. package/src/ui/dist/assets/{popover-DL6h35vr.js → popover-CLc0pPP8.js} +1 -1
  75. package/src/ui/dist/assets/{project-sync-CsX08Qno.js → project-sync-C9IdzdZW.js} +1 -1
  76. package/src/ui/dist/assets/{select-DvmXt1yY.js → select-Cs2PmzwL.js} +1 -1
  77. package/src/ui/dist/assets/{sigma-7jpXazui.js → sigma-ClKcHAXm.js} +1 -1
  78. package/src/ui/dist/assets/{trash-xA7kFt8i.js → trash-DwpbFr3w.js} +1 -1
  79. package/src/ui/dist/assets/{useCliAccess-DsMwDjOp.js → useCliAccess-NQ8m0Let.js} +1 -1
  80. package/src/ui/dist/assets/{wrap-text-CwMn-iqb.js → wrap-text-BC-Hltpd.js} +1 -1
  81. package/src/ui/dist/assets/{zoom-out-R-GWEhzS.js → zoom-out-E_gaeAxL.js} +1 -1
  82. package/src/ui/dist/index.html +2 -2
package/README.md CHANGED
@@ -1,15 +1,9 @@
1
- <h1 align="center">
2
- <img src="assets/branding/logo.svg" alt="DeepScientist logo" width="92" />
1
+ <h1 align="center" style="font-size: 3.25rem; line-height: 1.02; margin-bottom: 0.4rem;">
2
+ <img src="assets/branding/logo.svg" alt="DeepScientist logo" width="50" />
3
3
  DeepScientist
4
4
  </h1>
5
5
 
6
6
 
7
- <p align="center">
8
- DeepScientist is a local-first AI research studio, Bring your own AI scientist onto your machine in 15 minutes.
9
- </p>
10
-
11
-
12
-
13
7
  <p align="center">
14
8
  <a href="https://github.com/ResearAI/DeepScientist">GitHub</a> |
15
9
  <a href="README_ZH.md">中文文档</a> |
@@ -20,10 +14,13 @@
20
14
 
21
15
  <p align="center">
22
16
  <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>
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>
17
+ <a href="https://event.baai.ac.cn/activities/962"><img alt="Watch Video" src="https://img.shields.io/badge/Watch-Video-5B7266?style=for-the-badge"></a>
24
18
  <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>
25
19
  <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>
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>
20
+ </p>
21
+
22
+ <p align="center">
23
+ <a href="https://openreview.net/forum?id=cZFgsLq8Gs"><img alt="ICLR 2026 Top 10 Badge" src="assets/readme/iclr2026_top10_badge.svg" height="44"></a>
27
24
  </p>
28
25
 
29
26
  <p align="center">
@@ -42,7 +39,9 @@
42
39
 
43
40
  ![deepscientist_install](https://github.com/user-attachments/assets/d8244944-4f70-4e08-94e3-002b74ce70fb)
44
41
 
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.
42
+ Unlike one-shot **AI Scientist** or **autoresearch-style systems**, DeepScientist is a **local-first autonomous research studio** that keeps the full loop moving on your machine, from **baselines** and **experiment rounds** to **paper-ready outputs**, with a **10-minute setup**. Powered by **Findings Memory**, **Bayesian optimization**, and the **Research Map**, it keeps turning each new result into the next starting point and goes deep through broader exploration and, when needed, **thousands of experiment validations**.
43
+
44
+ If you want the technical deep dive behind DeepScientist, watch the [Video](https://event.baai.ac.cn/activities/962).
46
45
 
47
46
  ---
48
47
 
@@ -252,7 +251,7 @@ Platform note: DeepScientist fully supports Linux and macOS. Native Windows supp
252
251
 
253
252
  ```bash
254
253
  npm install -g @researai/deepscientist
255
- codex --login
254
+ codex login
256
255
  ds --here
257
256
  ```
258
257
 
@@ -262,7 +261,7 @@ To stop the managed local daemon and all currently running agents:
262
261
  ds --stop
263
262
  ```
264
263
 
265
- If `codex --login` is unavailable, run this once first:
264
+ If you prefer the interactive first-run flow, run this once first:
266
265
 
267
266
  ```bash
268
267
  codex
@@ -273,10 +272,10 @@ If `codex` still appears to be missing after installing DeepScientist, take the
273
272
  ```bash
274
273
  npm install -g @openai/codex
275
274
  which codex
276
- codex --login
275
+ codex login
277
276
  ```
278
277
 
279
- If `which codex` still prints nothing after that, fix the npm global bin path first, then retry `codex --login` and `ds doctor`.
278
+ If `which codex` still prints nothing after that, fix the npm global bin path first, then retry `codex login` and `ds doctor`.
280
279
 
281
280
  After startup, the default local address is:
282
281
 
@@ -321,6 +320,7 @@ If this is your first run, prefer an isolated environment, a non-root user, and
321
320
  ### I want to connect my own models or external collaboration channels
322
321
 
323
322
  - [15 Codex Provider Setup](docs/en/15_CODEX_PROVIDER_SETUP.md)
323
+ - [21 Local Model Backends Guide](docs/en/21_LOCAL_MODEL_BACKENDS_GUIDE.md)
324
324
  - [Weixin Connector Guide](docs/en/10_WEIXIN_CONNECTOR_GUIDE.md)
325
325
  - [QQ Connector Guide](docs/en/03_QQ_CONNECTOR_GUIDE.md)
326
326
  - [Telegram Connector Guide](docs/en/16_TELEGRAM_CONNECTOR_GUIDE.md)
@@ -380,7 +380,7 @@ If you are developing or maintaining DeepScientist, continue with:
380
380
 
381
381
  ## Citation
382
382
 
383
- If DeepScientist helps your research or engineering work, please cite:
383
+ If DeepScientist helps your research or engineering work, please cite the paper below. DeepScientist is jointly developed by Yixuan Weng, Weixu Zhao, Shichen Li, Zhen Lin, and Minjun Zhu.
384
384
 
385
385
  ```bibtex
386
386
  @inproceedings{
@@ -400,16 +400,59 @@ If this feels like the research workflow you have been waiting for, give the pro
400
400
  Welcome to join the WeChat group for discussion.
401
401
 
402
402
  <p align="center">
403
- <img src="assets/readme/wechat.jpg" alt="DeepScientist WeChat group" width="360" />
403
+ <img src="assets/readme/wechat5.jpg" alt="DeepScientist WeChat group" width="360" />
404
404
  </p>
405
405
 
406
406
  ## More From ResearAI
407
407
 
408
408
  If you like DeepScientist, you may also want to explore the rest of the ResearAI ecosystem:
409
409
 
410
- | Project | What it does |
411
- |---|---|
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 |
415
- | [Awesome-AI-Scientist](https://github.com/ResearAI/Awesome-AI-Scientist) | curated AI scientist landscape |
410
+ | Project | What it does | Stars |
411
+ |---|---|---|
412
+ | **[MeOS](https://github.com/ResearAI/MeOS)** | Fork yourself as a Skill, so agents understand you better | ![GitHub stars](https://img.shields.io/github/stars/ResearAI/MeOS?style=flat&logo=github) |
413
+ | [AutoFigure](https://github.com/ResearAI/AutoFigure) | generate publication-ready figures | ![GitHub stars](https://img.shields.io/github/stars/ResearAI/AutoFigure?style=flat&logo=github) |
414
+ | [AutoFigure-Edit](https://github.com/ResearAI/AutoFigure-Edit) | generate editable vector paper figures | ![GitHub stars](https://img.shields.io/github/stars/ResearAI/AutoFigure-Edit?style=flat&logo=github) |
415
+ | [DeepReviewer-v2](https://github.com/ResearAI/DeepReviewer-v2) | review papers and suggest revisions | ![GitHub stars](https://img.shields.io/github/stars/ResearAI/DeepReviewer-v2?style=flat&logo=github) |
416
+ | [Awesome-AI-Scientist](https://github.com/ResearAI/Awesome-AI-Scientist) | curated AI scientist landscape | ![GitHub stars](https://img.shields.io/github/stars/ResearAI/Awesome-AI-Scientist?style=flat&logo=github) |
417
+
418
+ ## Roadmap
419
+
420
+ We are building DeepScientist as a long-term local-first research operating system.
421
+
422
+ The next major upgrades focus on four directions:
423
+
424
+ ### 1. Deeper Research Loops
425
+
426
+ - AI Scientist Benchmark support for more realistic evaluation and comparison
427
+ - smoother automatic baseline upload, download, and reuse
428
+ - stronger experiment replay, comparison, and paper-facing outputs
429
+
430
+ ### 2. Stronger Long-Horizon Memory
431
+
432
+ - stronger Memory and Findings Memory mechanisms
433
+ - better cross-run and cross-quest reuse
434
+ - less repeated failure and less rediscovery cost over long projects
435
+
436
+ ### 3. Richer Multimodal And Collaborative Workflows
437
+
438
+ - VideoAnything-style multimodal research capabilities
439
+ - better local-model, connector, and copilot/autonomous collaboration flows
440
+ - a more efficient and more reliable DeepScientist system across local, collaborative, and long-horizon research settings
441
+
442
+ ### 4. Stronger Security And Safer Deployment
443
+
444
+ - safer local-first and server-side deployment defaults
445
+ - stronger auth, permission, and connector-surface protection
446
+ - less fabrication, lower hallucination, and more verification-grounded outputs
447
+ - better auditability for long-running autonomous research workflows
448
+
449
+ If this direction is interesting to you, please give the project a `Watch` and a `Star`:
450
+
451
+ [![Watch DeepScientist](https://img.shields.io/github/watchers/ResearAI/DeepScientist?style=for-the-badge&logo=github&label=Watch%20DeepScientist)](https://github.com/ResearAI/DeepScientist/watchers)
452
+ [![Star DeepScientist](https://img.shields.io/github/stars/ResearAI/DeepScientist?style=for-the-badge&logo=github&label=Star%20DeepScientist)](https://github.com/ResearAI/DeepScientist/stargazers)
453
+
454
+ ---
455
+
456
+ This project is maintained by WestlakeNLP. If you run into problems, please ask on [DeepWiki](https://deepwiki.com/ResearAI/DeepScientist) first; if it still cannot be resolved, open an issue.
457
+
458
+ WestlakeNLP is led by ACL Fellow Professor Yue Zhang. If you are interested in a long-term internship, PhD position, or research assistant opportunity, contact Professor Yue Zhang at `zhangyue@westlake.edu.cn`.