deepcode-hku 1.0.8__tar.gz → 1.0.9__tar.gz

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 (75) hide show
  1. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/PKG-INFO +128 -14
  2. deepcode_hku-1.0.8/deepcode_hku.egg-info/PKG-INFO → deepcode_hku-1.0.9/README.md +121 -59
  3. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/__init__.py +1 -1
  4. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/cli/cli_app.py +205 -5
  5. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/cli/cli_interface.py +206 -1
  6. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/cli/main_cli.py +65 -10
  7. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/cli/workflows/cli_workflow_adapter.py +79 -1
  8. deepcode_hku-1.0.9/deepcode.py +587 -0
  9. deepcode_hku-1.0.8/README.md → deepcode_hku-1.0.9/deepcode_hku.egg-info/PKG-INFO +173 -13
  10. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/deepcode_hku.egg-info/SOURCES.txt +7 -1
  11. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/deepcode_hku.egg-info/requires.txt +6 -0
  12. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/mcp_agent.config.yaml +18 -10
  13. deepcode_hku-1.0.9/mcp_agent.secrets.yaml +14 -0
  14. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/requirements.txt +9 -0
  15. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/code_indexer.py +4 -1
  16. deepcode_hku-1.0.9/ui/components.py +970 -0
  17. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/ui/handlers.py +189 -2
  18. deepcode_hku-1.0.9/ui/layout.py +142 -0
  19. deepcode_hku-1.0.9/ui/sidebar_feed.py +91 -0
  20. deepcode_hku-1.0.9/ui/styles.py +356 -0
  21. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/utils/llm_utils.py +164 -49
  22. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/agent_orchestration_engine.py +60 -11
  23. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/code_implementation_workflow.py +30 -11
  24. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/code_implementation_workflow_index.py +30 -11
  25. deepcode_hku-1.0.9/workflows/plugins/__init__.py +12 -0
  26. deepcode_hku-1.0.9/workflows/plugins/base.py +392 -0
  27. deepcode_hku-1.0.9/workflows/plugins/integration.py +283 -0
  28. deepcode_hku-1.0.9/workflows/plugins/plan_review.py +221 -0
  29. deepcode_hku-1.0.9/workflows/plugins/requirement_analysis.py +185 -0
  30. deepcode_hku-1.0.8/deepcode.py +0 -292
  31. deepcode_hku-1.0.8/mcp_agent.secrets.yaml +0 -7
  32. deepcode_hku-1.0.8/ui/components.py +0 -1621
  33. deepcode_hku-1.0.8/ui/layout.py +0 -161
  34. deepcode_hku-1.0.8/ui/styles.py +0 -3909
  35. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/.pre-commit-config.yaml +0 -0
  36. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/LICENSE +0 -0
  37. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/MANIFEST.in +0 -0
  38. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/cli/__init__.py +0 -0
  39. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/cli/cli_launcher.py +0 -0
  40. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/cli/workflows/__init__.py +0 -0
  41. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/deepcode_hku.egg-info/dependency_links.txt +0 -0
  42. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/deepcode_hku.egg-info/entry_points.txt +0 -0
  43. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/deepcode_hku.egg-info/top_level.txt +0 -0
  44. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/prompts/code_prompts.py +0 -0
  45. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/schema/mcp-agent.config.schema.json +0 -0
  46. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/setup.cfg +0 -0
  47. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/setup.py +0 -0
  48. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/__init__.py +0 -0
  49. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/bocha_search_server.py +0 -0
  50. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/code_implementation_server.py +0 -0
  51. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/code_reference_indexer.py +0 -0
  52. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/command_executor.py +0 -0
  53. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/document_segmentation_server.py +0 -0
  54. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/git_command.py +0 -0
  55. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/pdf_converter.py +0 -0
  56. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/pdf_downloader.py +0 -0
  57. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/tools/pdf_utils.py +0 -0
  58. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/ui/__init__.py +0 -0
  59. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/ui/app.py +0 -0
  60. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/ui/streamlit_app.py +0 -0
  61. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/utils/__init__.py +0 -0
  62. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/utils/cli_interface.py +0 -0
  63. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/utils/cross_platform_file_handler.py +0 -0
  64. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/utils/dialogue_logger.py +0 -0
  65. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/utils/file_processor.py +0 -0
  66. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/utils/simple_llm_logger.py +0 -0
  67. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/__init__.py +0 -0
  68. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/agents/__init__.py +0 -0
  69. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/agents/code_implementation_agent.py +0 -0
  70. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/agents/document_segmentation_agent.py +0 -0
  71. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/agents/memory_agent_concise.py +0 -0
  72. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/agents/memory_agent_concise_index.py +0 -0
  73. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/agents/memory_agent_concise_multi.py +0 -0
  74. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/agents/requirement_analysis_agent.py +0 -0
  75. {deepcode_hku-1.0.8 → deepcode_hku-1.0.9}/workflows/codebase_index_workflow.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: deepcode-hku
3
- Version: 1.0.8
3
+ Version: 1.0.9
4
4
  Summary: AI Research Engine - Transform research papers into working code automatically
5
5
  Home-page: https://github.com/HKUDS/DeepCode
6
6
  Author: DeepCodeTeam
@@ -24,15 +24,21 @@ Requires-Dist: aiohttp>=3.8.0
24
24
  Requires-Dist: anthropic
25
25
  Requires-Dist: asyncio-mqtt
26
26
  Requires-Dist: docling
27
+ Requires-Dist: fastapi>=0.104.0
27
28
  Requires-Dist: google-genai
28
29
  Requires-Dist: mcp-agent
29
30
  Requires-Dist: mcp-server-git
30
31
  Requires-Dist: nest_asyncio
31
32
  Requires-Dist: openai
32
33
  Requires-Dist: pathlib2
34
+ Requires-Dist: pydantic-settings>=2.0.0
33
35
  Requires-Dist: PyPDF2>=2.0.0
36
+ Requires-Dist: python-multipart>=0.0.6
37
+ Requires-Dist: PyYAML>=6.0
34
38
  Requires-Dist: reportlab>=3.5.0
35
39
  Requires-Dist: streamlit
40
+ Requires-Dist: uvicorn>=0.24.0
41
+ Requires-Dist: websockets>=12.0
36
42
  Dynamic: author
37
43
  Dynamic: classifier
38
44
  Dynamic: description
@@ -81,8 +87,9 @@ Dynamic: summary
81
87
  </p> -->
82
88
  <p>
83
89
  <a href="https://github.com/HKUDS/DeepCode/stargazers"><img src='https://img.shields.io/github/stars/HKUDS/DeepCode?color=00d9ff&style=for-the-badge&logo=star&logoColor=white&labelColor=1a1a2e' /></a>
90
+ <a href='https://arxiv.org/abs/2512.07921'><img src="https://img.shields.io/badge/Paper-arXiv-orange?style=for-the-badge&logo=arxiv&logoColor=white&labelColor=1a1a2e"></a>
84
91
  <img src="https://img.shields.io/badge/🐍Python-3.13-4ecdc4?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e">
85
- <a href="https://pypi.org/project/deepcode-hku/"><img src="https://img.shields.io/pypi/v/deepcode-hku.svg?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1a1a2e&color=ff6b6b"></a>
92
+ <!-- <a href="https://pypi.org/project/deepcode-hku/"><img src="https://img.shields.io/pypi/v/deepcode-hku.svg?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1a1a2e&color=ff6b6b"></a> -->
86
93
  </p>
87
94
  <p>
88
95
  <a href="https://discord.gg/yF2MmDJyGJ"><img src="https://img.shields.io/badge/💬Discord-Community-7289da?style=for-the-badge&logo=discord&logoColor=white&labelColor=1a1a2e"></a>
@@ -203,6 +210,22 @@ Dynamic: summary
203
210
 
204
211
  ## 📰 News
205
212
 
213
+ 🎨 **[2025-02] New Web UI Experience Upgrade!**
214
+
215
+ - 🔄 **User-in-Loop Interaction**: Support real-time user interaction during workflows - AI asks clarifying questions directly in the chat
216
+ - 💬 **Inline Interaction Design**: Interaction prompts appear naturally within the chat flow for a seamless experience
217
+ - 🚀 **One-Click Launch**: Simply run `deepcode` to start the new UI (cross-platform: Windows/macOS/Linux)
218
+ - 🔧 **Improved Process Management**: Enhanced service start/stop mechanism with automatic port cleanup
219
+ - 📡 **WebSocket Real-time Communication**: Fixed message loss issues, ensuring proper interaction state synchronization
220
+
221
+ <div align="center">
222
+ <img src="./assets/NewUI.png" alt="DeepCode New UI" width="85%" style="border-radius: 12px; box-shadow: 0 4px 20px rgba(0,0,0,0.15);" />
223
+ <br/>
224
+ <sub><em>DeepCode New Web UI - Modern React-based Interface</em></sub>
225
+ </div>
226
+
227
+ ---
228
+
206
229
  🎉 **[2025-10] 🎉 [2025-10-28] DeepCode Achieves SOTA on PaperBench!**
207
230
 
208
231
  DeepCode sets new benchmarks on OpenAI's PaperBench Code-Dev across all categories:
@@ -570,7 +593,39 @@ Implementation Generation • Testing • Documentation
570
593
 
571
594
  ## 🚀 Quick Start
572
595
 
596
+ ### 📋 **Prerequisites**
597
+
598
+ Before installing DeepCode, ensure you have the following:
599
+
600
+ | Requirement | Version | Purpose |
601
+ |-------------|---------|---------|
602
+ | **Python** | 3.9+ | Core runtime |
603
+ | **Node.js** | 18+ | New UI frontend |
604
+ | **npm** | 8+ | Package management |
605
+
606
+ ```bash
607
+ # Check your versions
608
+ python --version # Should be 3.9+
609
+ node --version # Should be 18+
610
+ npm --version # Should be 8+
611
+ ```
612
+
613
+ <details>
614
+ <summary><strong>📥 Install Node.js (if not installed)</strong></summary>
615
+
616
+ ```bash
617
+ # macOS (using Homebrew)
618
+ brew install node
619
+
620
+ # Ubuntu/Debian
621
+ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
622
+ sudo apt-get install -y nodejs
573
623
 
624
+ # Windows
625
+ # Download from https://nodejs.org/
626
+ ```
627
+
628
+ </details>
574
629
 
575
630
  ### 📦 **Step 1: Installation**
576
631
 
@@ -759,28 +814,64 @@ bocha-mcp:
759
814
 
760
815
  ### ⚡ **Step 2: Launch Application**
761
816
 
762
- #### 🚀 **Using Installed Package (Recommended)**
817
+ #### 🚀 **Using `deepcode` Command (Recommended)**
763
818
 
764
819
  ```bash
765
- # 🌐 Launch web interface directly
820
+ # 🌐 Launch the new React-based web interface
766
821
  deepcode
767
822
 
768
- # The application will automatically start at http://localhost:8501
823
+ # Frontend: http://localhost:5173
824
+ # Backend API: http://localhost:8000
825
+ # Press Ctrl+C to stop all services
769
826
  ```
827
+ <div align="center">
828
+ <img src="https://img.shields.io/badge/Frontend-localhost:5173-00d4ff?style=flat-square&logo=react&logoColor=white" alt="Frontend" />
829
+ <img src="https://img.shields.io/badge/Backend-localhost:8000-4ecdc4?style=flat-square&logo=fastapi&logoColor=white" alt="Backend" />
830
+ </div>
831
+
832
+ > **📦 Auto Install**: On first run, dependencies are automatically installed (`pip install` for backend, `npm install` for frontend)
770
833
 
771
- #### 🛠️ **Using Source Code**
834
+ > **✨ Features**: User-in-Loop interaction, real-time progress tracking, inline chat interaction
772
835
 
773
- Choose your preferred interface:
836
+ #### 🛠️ **Alternative Launch Methods**
837
+
838
+ <table>
839
+ <tr>
840
+ <td><strong>🍎 macOS / 🐧 Linux</strong></td>
841
+ <td><strong>🪟 Windows</strong></td>
842
+ </tr>
843
+ <tr>
844
+ <td>
774
845
 
775
- ##### 🌐 **Web Interface** (Recommended)
776
846
  ```bash
777
- # Using UV
778
- uv run streamlit run ui/streamlit_app.py
779
- # Or using traditional Python
780
- streamlit run ui/streamlit_app.py
847
+ # Using run.sh
848
+ ./run.sh
849
+
850
+ # Or using Python directly
851
+ python deepcode.py
852
+ ```
853
+
854
+ </td>
855
+ <td>
856
+
857
+ ```cmd
858
+ # Using run.bat
859
+ run.bat
860
+
861
+ # Or using Python directly
862
+ python deepcode.py
863
+ ```
864
+
865
+ </td>
866
+ </tr>
867
+ </table>
868
+
869
+ ```bash
870
+ # Classic Streamlit UI (all platforms)
871
+ deepcode --classic
781
872
  ```
782
873
  <div align="center">
783
- <img src="https://img.shields.io/badge/Access-localhost:8501-00d4ff?style=flat-square&logo=streamlit&logoColor=white" alt="Web Access" />
874
+ <img src="https://img.shields.io/badge/Classic_UI-localhost:8501-00d4ff?style=flat-square&logo=streamlit&logoColor=white" alt="Classic UI" />
784
875
  </div>
785
876
 
786
877
  ##### 🖥️ **CLI Interface** (Advanced Users)
@@ -925,8 +1016,32 @@ We're continuously enhancing DeepCode with exciting new features:
925
1016
 
926
1017
  ---
927
1018
 
1019
+ <div align="left">
1020
+
1021
+ ### 📖 **Citation**
1022
+
1023
+
1024
+ If you find DeepCode useful in your research or applications, please kindly cite:
1025
+
1026
+ ```
1027
+ @misc{li2025deepcodeopenagenticcoding,
1028
+ title={DeepCode: Open Agentic Coding},
1029
+ author={Zongwei Li and Zhonghang Li and Zirui Guo and Xubin Ren and Chao Huang},
1030
+ year={2025},
1031
+ eprint={2512.07921},
1032
+ archivePrefix={arXiv},
1033
+ primaryClass={cs.SE},
1034
+ url={https://arxiv.org/abs/2512.07921},
1035
+ }
1036
+ ```
1037
+
1038
+ ---
1039
+
1040
+
928
1041
  ### 📄 **License**
929
1042
 
1043
+ <div align="center">
1044
+
930
1045
  <img src="https://img.shields.io/badge/License-MIT-4ecdc4?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="MIT License">
931
1046
 
932
1047
  **MIT License** - Copyright (c) 2025 Data Intelligence Lab, The University of Hong Kong
@@ -934,7 +1049,6 @@ We're continuously enhancing DeepCode with exciting new features:
934
1049
  ---
935
1050
 
936
1051
 
937
-
938
1052
  <img src="https://visitor-badge.laobi.icu/badge?page_id=deepcode.readme&style=for-the-badge&color=00d4ff" alt="Visitors">
939
1053
 
940
1054
  </div>
@@ -1,49 +1,3 @@
1
- Metadata-Version: 2.4
2
- Name: deepcode-hku
3
- Version: 1.0.8
4
- Summary: AI Research Engine - Transform research papers into working code automatically
5
- Home-page: https://github.com/HKUDS/DeepCode
6
- Author: DeepCodeTeam
7
- Project-URL: Documentation, https://github.com/HKUDS/DeepCode
8
- Project-URL: Source, https://github.com/HKUDS/DeepCode
9
- Project-URL: Tracker, https://github.com/HKUDS/DeepCode/issues
10
- Classifier: Development Status :: 4 - Beta
11
- Classifier: Programming Language :: Python :: 3
12
- Classifier: License :: OSI Approved :: MIT License
13
- Classifier: Operating System :: OS Independent
14
- Classifier: Intended Audience :: Developers
15
- Classifier: Intended Audience :: Science/Research
16
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
17
- Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
18
- Classifier: Topic :: Text Processing :: Linguistic
19
- Requires-Python: >=3.9
20
- Description-Content-Type: text/markdown
21
- License-File: LICENSE
22
- Requires-Dist: aiofiles>=0.8.0
23
- Requires-Dist: aiohttp>=3.8.0
24
- Requires-Dist: anthropic
25
- Requires-Dist: asyncio-mqtt
26
- Requires-Dist: docling
27
- Requires-Dist: google-genai
28
- Requires-Dist: mcp-agent
29
- Requires-Dist: mcp-server-git
30
- Requires-Dist: nest_asyncio
31
- Requires-Dist: openai
32
- Requires-Dist: pathlib2
33
- Requires-Dist: PyPDF2>=2.0.0
34
- Requires-Dist: reportlab>=3.5.0
35
- Requires-Dist: streamlit
36
- Dynamic: author
37
- Dynamic: classifier
38
- Dynamic: description
39
- Dynamic: description-content-type
40
- Dynamic: home-page
41
- Dynamic: license-file
42
- Dynamic: project-url
43
- Dynamic: requires-dist
44
- Dynamic: requires-python
45
- Dynamic: summary
46
-
47
1
  <div align="center">
48
2
 
49
3
  <table style="border: none; margin: 0 auto; padding: 0; border-collapse: collapse;">
@@ -81,8 +35,9 @@ Dynamic: summary
81
35
  </p> -->
82
36
  <p>
83
37
  <a href="https://github.com/HKUDS/DeepCode/stargazers"><img src='https://img.shields.io/github/stars/HKUDS/DeepCode?color=00d9ff&style=for-the-badge&logo=star&logoColor=white&labelColor=1a1a2e' /></a>
38
+ <a href='https://arxiv.org/abs/2512.07921'><img src="https://img.shields.io/badge/Paper-arXiv-orange?style=for-the-badge&logo=arxiv&logoColor=white&labelColor=1a1a2e"></a>
84
39
  <img src="https://img.shields.io/badge/🐍Python-3.13-4ecdc4?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e">
85
- <a href="https://pypi.org/project/deepcode-hku/"><img src="https://img.shields.io/pypi/v/deepcode-hku.svg?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1a1a2e&color=ff6b6b"></a>
40
+ <!-- <a href="https://pypi.org/project/deepcode-hku/"><img src="https://img.shields.io/pypi/v/deepcode-hku.svg?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1a1a2e&color=ff6b6b"></a> -->
86
41
  </p>
87
42
  <p>
88
43
  <a href="https://discord.gg/yF2MmDJyGJ"><img src="https://img.shields.io/badge/💬Discord-Community-7289da?style=for-the-badge&logo=discord&logoColor=white&labelColor=1a1a2e"></a>
@@ -203,6 +158,22 @@ Dynamic: summary
203
158
 
204
159
  ## 📰 News
205
160
 
161
+ 🎨 **[2025-02] New Web UI Experience Upgrade!**
162
+
163
+ - 🔄 **User-in-Loop Interaction**: Support real-time user interaction during workflows - AI asks clarifying questions directly in the chat
164
+ - 💬 **Inline Interaction Design**: Interaction prompts appear naturally within the chat flow for a seamless experience
165
+ - 🚀 **One-Click Launch**: Simply run `deepcode` to start the new UI (cross-platform: Windows/macOS/Linux)
166
+ - 🔧 **Improved Process Management**: Enhanced service start/stop mechanism with automatic port cleanup
167
+ - 📡 **WebSocket Real-time Communication**: Fixed message loss issues, ensuring proper interaction state synchronization
168
+
169
+ <div align="center">
170
+ <img src="./assets/NewUI.png" alt="DeepCode New UI" width="85%" style="border-radius: 12px; box-shadow: 0 4px 20px rgba(0,0,0,0.15);" />
171
+ <br/>
172
+ <sub><em>DeepCode New Web UI - Modern React-based Interface</em></sub>
173
+ </div>
174
+
175
+ ---
176
+
206
177
  🎉 **[2025-10] 🎉 [2025-10-28] DeepCode Achieves SOTA on PaperBench!**
207
178
 
208
179
  DeepCode sets new benchmarks on OpenAI's PaperBench Code-Dev across all categories:
@@ -570,7 +541,39 @@ Implementation Generation • Testing • Documentation
570
541
 
571
542
  ## 🚀 Quick Start
572
543
 
544
+ ### 📋 **Prerequisites**
545
+
546
+ Before installing DeepCode, ensure you have the following:
547
+
548
+ | Requirement | Version | Purpose |
549
+ |-------------|---------|---------|
550
+ | **Python** | 3.9+ | Core runtime |
551
+ | **Node.js** | 18+ | New UI frontend |
552
+ | **npm** | 8+ | Package management |
553
+
554
+ ```bash
555
+ # Check your versions
556
+ python --version # Should be 3.9+
557
+ node --version # Should be 18+
558
+ npm --version # Should be 8+
559
+ ```
560
+
561
+ <details>
562
+ <summary><strong>📥 Install Node.js (if not installed)</strong></summary>
563
+
564
+ ```bash
565
+ # macOS (using Homebrew)
566
+ brew install node
567
+
568
+ # Ubuntu/Debian
569
+ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
570
+ sudo apt-get install -y nodejs
573
571
 
572
+ # Windows
573
+ # Download from https://nodejs.org/
574
+ ```
575
+
576
+ </details>
574
577
 
575
578
  ### 📦 **Step 1: Installation**
576
579
 
@@ -759,28 +762,64 @@ bocha-mcp:
759
762
 
760
763
  ### ⚡ **Step 2: Launch Application**
761
764
 
762
- #### 🚀 **Using Installed Package (Recommended)**
765
+ #### 🚀 **Using `deepcode` Command (Recommended)**
763
766
 
764
767
  ```bash
765
- # 🌐 Launch web interface directly
768
+ # 🌐 Launch the new React-based web interface
766
769
  deepcode
767
770
 
768
- # The application will automatically start at http://localhost:8501
771
+ # Frontend: http://localhost:5173
772
+ # Backend API: http://localhost:8000
773
+ # Press Ctrl+C to stop all services
774
+ ```
775
+ <div align="center">
776
+ <img src="https://img.shields.io/badge/Frontend-localhost:5173-00d4ff?style=flat-square&logo=react&logoColor=white" alt="Frontend" />
777
+ <img src="https://img.shields.io/badge/Backend-localhost:8000-4ecdc4?style=flat-square&logo=fastapi&logoColor=white" alt="Backend" />
778
+ </div>
779
+
780
+ > **📦 Auto Install**: On first run, dependencies are automatically installed (`pip install` for backend, `npm install` for frontend)
781
+
782
+ > **✨ Features**: User-in-Loop interaction, real-time progress tracking, inline chat interaction
783
+
784
+ #### 🛠️ **Alternative Launch Methods**
785
+
786
+ <table>
787
+ <tr>
788
+ <td><strong>🍎 macOS / 🐧 Linux</strong></td>
789
+ <td><strong>🪟 Windows</strong></td>
790
+ </tr>
791
+ <tr>
792
+ <td>
793
+
794
+ ```bash
795
+ # Using run.sh
796
+ ./run.sh
797
+
798
+ # Or using Python directly
799
+ python deepcode.py
769
800
  ```
770
801
 
771
- #### 🛠️ **Using Source Code**
802
+ </td>
803
+ <td>
804
+
805
+ ```cmd
806
+ # Using run.bat
807
+ run.bat
772
808
 
773
- Choose your preferred interface:
809
+ # Or using Python directly
810
+ python deepcode.py
811
+ ```
812
+
813
+ </td>
814
+ </tr>
815
+ </table>
774
816
 
775
- ##### 🌐 **Web Interface** (Recommended)
776
817
  ```bash
777
- # Using UV
778
- uv run streamlit run ui/streamlit_app.py
779
- # Or using traditional Python
780
- streamlit run ui/streamlit_app.py
818
+ # Classic Streamlit UI (all platforms)
819
+ deepcode --classic
781
820
  ```
782
821
  <div align="center">
783
- <img src="https://img.shields.io/badge/Access-localhost:8501-00d4ff?style=flat-square&logo=streamlit&logoColor=white" alt="Web Access" />
822
+ <img src="https://img.shields.io/badge/Classic_UI-localhost:8501-00d4ff?style=flat-square&logo=streamlit&logoColor=white" alt="Classic UI" />
784
823
  </div>
785
824
 
786
825
  ##### 🖥️ **CLI Interface** (Advanced Users)
@@ -925,8 +964,32 @@ We're continuously enhancing DeepCode with exciting new features:
925
964
 
926
965
  ---
927
966
 
967
+ <div align="left">
968
+
969
+ ### 📖 **Citation**
970
+
971
+
972
+ If you find DeepCode useful in your research or applications, please kindly cite:
973
+
974
+ ```
975
+ @misc{li2025deepcodeopenagenticcoding,
976
+ title={DeepCode: Open Agentic Coding},
977
+ author={Zongwei Li and Zhonghang Li and Zirui Guo and Xubin Ren and Chao Huang},
978
+ year={2025},
979
+ eprint={2512.07921},
980
+ archivePrefix={arXiv},
981
+ primaryClass={cs.SE},
982
+ url={https://arxiv.org/abs/2512.07921},
983
+ }
984
+ ```
985
+
986
+ ---
987
+
988
+
928
989
  ### 📄 **License**
929
990
 
991
+ <div align="center">
992
+
930
993
  <img src="https://img.shields.io/badge/License-MIT-4ecdc4?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="MIT License">
931
994
 
932
995
  **MIT License** - Copyright (c) 2025 Data Intelligence Lab, The University of Hong Kong
@@ -934,7 +997,6 @@ We're continuously enhancing DeepCode with exciting new features:
934
997
  ---
935
998
 
936
999
 
937
-
938
1000
  <img src="https://visitor-badge.laobi.icu/badge?page_id=deepcode.readme&style=for-the-badge&color=00d4ff" alt="Visitors">
939
1001
 
940
1002
  </div>
@@ -5,7 +5,7 @@ DeepCode - AI Research Engine
5
5
  ⚡ Transform research papers into working code automatically
6
6
  """
7
7
 
8
- __version__ = "1.0.8"
8
+ __version__ = "1.0.9"
9
9
  __author__ = "DeepCode Team"
10
10
  __url__ = "https://github.com/HKUDS/DeepCode"
11
11