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

{deepcode_hku-1.0.7 → deepcode_hku-1.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepcode-hku
-Version: 1.0.7
+Version: 1.0.9
 Summary: AI Research Engine - Transform research papers into working code automatically
 Home-page: https://github.com/HKUDS/DeepCode
 Author: DeepCodeTeam
@@ -24,14 +24,21 @@ Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: anthropic
 Requires-Dist: asyncio-mqtt
 Requires-Dist: docling
+Requires-Dist: fastapi>=0.104.0
+Requires-Dist: google-genai
 Requires-Dist: mcp-agent
 Requires-Dist: mcp-server-git
 Requires-Dist: nest_asyncio
 Requires-Dist: openai
 Requires-Dist: pathlib2
+Requires-Dist: pydantic-settings>=2.0.0
 Requires-Dist: PyPDF2>=2.0.0
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: PyYAML>=6.0
 Requires-Dist: reportlab>=3.5.0
 Requires-Dist: streamlit
+Requires-Dist: uvicorn>=0.24.0
+Requires-Dist: websockets>=12.0
 Dynamic: author
 Dynamic: classifier
 Dynamic: description
@@ -80,8 +87,9 @@ Dynamic: summary
 </p> -->
 <p>
   <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>
+  <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>
   <img src="https://img.shields.io/badge/🐍Python-3.13-4ecdc4?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e">
-  <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>
+  <!-- <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> -->
 </p>
 <p>
   <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>
@@ -202,6 +210,22 @@ Dynamic: summary
 
 ## 📰 News
 
+🎨 **[2025-02] New Web UI Experience Upgrade!**
+
+- 🔄 **User-in-Loop Interaction**: Support real-time user interaction during workflows - AI asks clarifying questions directly in the chat
+- 💬 **Inline Interaction Design**: Interaction prompts appear naturally within the chat flow for a seamless experience
+- 🚀 **One-Click Launch**: Simply run `deepcode` to start the new UI (cross-platform: Windows/macOS/Linux)
+- 🔧 **Improved Process Management**: Enhanced service start/stop mechanism with automatic port cleanup
+- 📡 **WebSocket Real-time Communication**: Fixed message loss issues, ensuring proper interaction state synchronization
+
+<div align="center">
+  <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);" />
+  <br/>
+  <sub><em>DeepCode New Web UI - Modern React-based Interface</em></sub>
+</div>
+
+---
+
 🎉 **[2025-10] 🎉 [2025-10-28] DeepCode Achieves SOTA on PaperBench!**
 
 DeepCode sets new benchmarks on OpenAI's PaperBench Code-Dev across all categories:
@@ -569,7 +593,39 @@ Implementation Generation • Testing • Documentation
 
 ## 🚀 Quick Start
 
+### 📋 **Prerequisites**
+
+Before installing DeepCode, ensure you have the following:
 
+| Requirement | Version | Purpose |
+|-------------|---------|---------|
+| **Python** | 3.9+ | Core runtime |
+| **Node.js** | 18+ | New UI frontend |
+| **npm** | 8+ | Package management |
+
+```bash
+# Check your versions
+python --version   # Should be 3.9+
+node --version     # Should be 18+
+npm --version      # Should be 8+
+```
+
+<details>
+<summary><strong>📥 Install Node.js (if not installed)</strong></summary>
+
+```bash
+# macOS (using Homebrew)
+brew install node
+
+# Ubuntu/Debian
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# Windows
+# Download from https://nodejs.org/
+```
+
+</details>
 
 ### 📦 **Step 1: Installation**
 
@@ -587,6 +643,14 @@ curl -O https://raw.githubusercontent.com/HKUDS/DeepCode/main/mcp_agent.secrets.
 # Edit mcp_agent.secrets.yaml with your API keys and base_url:
 # - openai: api_key, base_url (for OpenAI/custom endpoints)
 # - anthropic: api_key (for Claude models)
+# - google: api_key (for Gemini models)
+
+# 🤖 Select your preferred LLM provider (optional)
+# Edit mcp_agent.config.yaml to choose your LLM (line ~106):
+# - llm_provider: "google"    # Use Google Gemini models
+# - llm_provider: "anthropic" # Use Anthropic Claude models
+# - llm_provider: "openai"    # Use OpenAI/compatible models
+# Note: If not set or unavailable, will automatically fallback to first available provider
 
 # 🔑 Configure search API keys for web search (optional)
 # Edit mcp_agent.config.yaml to set your API keys:
@@ -623,6 +687,14 @@ uv pip install -r requirements.txt
 # Edit mcp_agent.secrets.yaml with your API keys and base_url:
 # - openai: api_key, base_url (for OpenAI/custom endpoints)
 # - anthropic: api_key (for Claude models)
+# - google: api_key (for Gemini models)
+
+# 🤖 Select your preferred LLM provider (optional)
+# Edit mcp_agent.config.yaml to choose your LLM (line ~106):
+# - llm_provider: "google"    # Use Google Gemini models
+# - llm_provider: "anthropic" # Use Anthropic Claude models
+# - llm_provider: "openai"    # Use OpenAI/compatible models
+# Note: If not set or unavailable, will automatically fallback to first available provider
 
 # 🔑 Configure search API keys for web search (optional)
 # Edit mcp_agent.config.yaml to set your API keys:
@@ -649,6 +721,14 @@ pip install -r requirements.txt
 # Edit mcp_agent.secrets.yaml with your API keys and base_url:
 # - openai: api_key, base_url (for OpenAI/custom endpoints)
 # - anthropic: api_key (for Claude models)
+# - google: api_key (for Gemini models)
+
+# 🤖 Select your preferred LLM provider (optional)
+# Edit mcp_agent.config.yaml to choose your LLM (line ~106):
+# - llm_provider: "google"    # Use Google Gemini models
+# - llm_provider: "anthropic" # Use Anthropic Claude models
+# - llm_provider: "openai"    # Use OpenAI/compatible models
+# Note: If not set or unavailable, will automatically fallback to first available provider
 
 # 🔑 Configure search API keys for web search (optional)
 # Edit mcp_agent.config.yaml to set your API keys:
@@ -734,28 +814,64 @@ bocha-mcp:
 
 ### ⚡ **Step 2: Launch Application**
 
-#### 🚀 **Using Installed Package (Recommended)**
+#### 🚀 **Using `deepcode` Command (Recommended)**
 
 ```bash
-# 🌐 Launch web interface directly
+# 🌐 Launch the new React-based web interface
 deepcode
 
-# The application will automatically start at http://localhost:8501
+# Frontend: http://localhost:5173
+# Backend API: http://localhost:8000
+# Press Ctrl+C to stop all services
+```
+<div align="center">
+  <img src="https://img.shields.io/badge/Frontend-localhost:5173-00d4ff?style=flat-square&logo=react&logoColor=white" alt="Frontend" />
+  <img src="https://img.shields.io/badge/Backend-localhost:8000-4ecdc4?style=flat-square&logo=fastapi&logoColor=white" alt="Backend" />
+</div>
+
+> **📦 Auto Install**: On first run, dependencies are automatically installed (`pip install` for backend, `npm install` for frontend)
+
+> **✨ Features**: User-in-Loop interaction, real-time progress tracking, inline chat interaction
+
+#### 🛠️ **Alternative Launch Methods**
+
+<table>
+<tr>
+<td><strong>🍎 macOS / 🐧 Linux</strong></td>
+<td><strong>🪟 Windows</strong></td>
+</tr>
+<tr>
+<td>
+
+```bash
+# Using run.sh
+./run.sh
+
+# Or using Python directly
+python deepcode.py
 ```
 
-#### 🛠️ **Using Source Code**
+</td>
+<td>
 
-Choose your preferred interface:
+```cmd
+# Using run.bat
+run.bat
+
+# Or using Python directly
+python deepcode.py
+```
+
+</td>
+</tr>
+</table>
 
-##### 🌐 **Web Interface** (Recommended)
 ```bash
-# Using UV
-uv run streamlit run ui/streamlit_app.py
-# Or using traditional Python
-streamlit run ui/streamlit_app.py
+# Classic Streamlit UI (all platforms)
+deepcode --classic
 ```
 <div align="center">
-  <img src="https://img.shields.io/badge/Access-localhost:8501-00d4ff?style=flat-square&logo=streamlit&logoColor=white" alt="Web Access" />
+  <img src="https://img.shields.io/badge/Classic_UI-localhost:8501-00d4ff?style=flat-square&logo=streamlit&logoColor=white" alt="Classic UI" />
 </div>
 
 ##### 🖥️ **CLI Interface** (Advanced Users)
@@ -900,8 +1016,32 @@ We're continuously enhancing DeepCode with exciting new features:
 
 ---
 
+<div align="left">
+
+### 📖 **Citation**
+
+
+If you find DeepCode useful in your research or applications, please kindly cite:
+
+```
+@misc{li2025deepcodeopenagenticcoding,
+      title={DeepCode: Open Agentic Coding},
+      author={Zongwei Li and Zhonghang Li and Zirui Guo and Xubin Ren and Chao Huang},
+      year={2025},
+      eprint={2512.07921},
+      archivePrefix={arXiv},
+      primaryClass={cs.SE},
+      url={https://arxiv.org/abs/2512.07921},
+}
+```
+
+---
+
+
 ### 📄 **License**
 
+<div align="center">
+
 <img src="https://img.shields.io/badge/License-MIT-4ecdc4?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="MIT License">
 
 **MIT License** - Copyright (c) 2025 Data Intelligence Lab, The University of Hong Kong
@@ -909,7 +1049,6 @@ We're continuously enhancing DeepCode with exciting new features:
 ---
 
 
-
 <img src="https://visitor-badge.laobi.icu/badge?page_id=deepcode.readme&style=for-the-badge&color=00d4ff" alt="Visitors">
 
 </div>

deepcode_hku-1.0.7/deepcode_hku.egg-info/PKG-INFO → deepcode_hku-1.0.9/README.md

@@ -1,48 +1,3 @@
-Metadata-Version: 2.4
-Name: deepcode-hku
-Version: 1.0.7
-Summary: AI Research Engine - Transform research papers into working code automatically
-Home-page: https://github.com/HKUDS/DeepCode
-Author: DeepCodeTeam
-Project-URL: Documentation, https://github.com/HKUDS/DeepCode
-Project-URL: Source, https://github.com/HKUDS/DeepCode
-Project-URL: Tracker, https://github.com/HKUDS/DeepCode/issues
-Classifier: Development Status :: 4 - Beta
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Text Processing :: Linguistic
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiofiles>=0.8.0
-Requires-Dist: aiohttp>=3.8.0
-Requires-Dist: anthropic
-Requires-Dist: asyncio-mqtt
-Requires-Dist: docling
-Requires-Dist: mcp-agent
-Requires-Dist: mcp-server-git
-Requires-Dist: nest_asyncio
-Requires-Dist: openai
-Requires-Dist: pathlib2
-Requires-Dist: PyPDF2>=2.0.0
-Requires-Dist: reportlab>=3.5.0
-Requires-Dist: streamlit
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
 <div align="center">
 
 <table style="border: none; margin: 0 auto; padding: 0; border-collapse: collapse;">
@@ -80,8 +35,9 @@ Dynamic: summary
 </p> -->
 <p>
   <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>
+  <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>
   <img src="https://img.shields.io/badge/🐍Python-3.13-4ecdc4?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e">
-  <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>
+  <!-- <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> -->
 </p>
 <p>
   <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>
@@ -202,6 +158,22 @@ Dynamic: summary
 
 ## 📰 News
 
+🎨 **[2025-02] New Web UI Experience Upgrade!**
+
+- 🔄 **User-in-Loop Interaction**: Support real-time user interaction during workflows - AI asks clarifying questions directly in the chat
+- 💬 **Inline Interaction Design**: Interaction prompts appear naturally within the chat flow for a seamless experience
+- 🚀 **One-Click Launch**: Simply run `deepcode` to start the new UI (cross-platform: Windows/macOS/Linux)
+- 🔧 **Improved Process Management**: Enhanced service start/stop mechanism with automatic port cleanup
+- 📡 **WebSocket Real-time Communication**: Fixed message loss issues, ensuring proper interaction state synchronization
+
+<div align="center">
+  <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);" />
+  <br/>
+  <sub><em>DeepCode New Web UI - Modern React-based Interface</em></sub>
+</div>
+
+---
+
 🎉 **[2025-10] 🎉 [2025-10-28] DeepCode Achieves SOTA on PaperBench!**
 
 DeepCode sets new benchmarks on OpenAI's PaperBench Code-Dev across all categories:
@@ -569,7 +541,39 @@ Implementation Generation • Testing • Documentation
 
 ## 🚀 Quick Start
 
+### 📋 **Prerequisites**
+
+Before installing DeepCode, ensure you have the following:
+
+| Requirement | Version | Purpose |
+|-------------|---------|---------|
+| **Python** | 3.9+ | Core runtime |
+| **Node.js** | 18+ | New UI frontend |
+| **npm** | 8+ | Package management |
+
+```bash
+# Check your versions
+python --version   # Should be 3.9+
+node --version     # Should be 18+
+npm --version      # Should be 8+
+```
+
+<details>
+<summary><strong>📥 Install Node.js (if not installed)</strong></summary>
+
+```bash
+# macOS (using Homebrew)
+brew install node
+
+# Ubuntu/Debian
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# Windows
+# Download from https://nodejs.org/
+```
 
+</details>
 
 ### 📦 **Step 1: Installation**
 
@@ -587,6 +591,14 @@ curl -O https://raw.githubusercontent.com/HKUDS/DeepCode/main/mcp_agent.secrets.
 # Edit mcp_agent.secrets.yaml with your API keys and base_url:
 # - openai: api_key, base_url (for OpenAI/custom endpoints)
 # - anthropic: api_key (for Claude models)
+# - google: api_key (for Gemini models)
+
+# 🤖 Select your preferred LLM provider (optional)
+# Edit mcp_agent.config.yaml to choose your LLM (line ~106):
+# - llm_provider: "google"    # Use Google Gemini models
+# - llm_provider: "anthropic" # Use Anthropic Claude models
+# - llm_provider: "openai"    # Use OpenAI/compatible models
+# Note: If not set or unavailable, will automatically fallback to first available provider
 
 # 🔑 Configure search API keys for web search (optional)
 # Edit mcp_agent.config.yaml to set your API keys:
@@ -623,6 +635,14 @@ uv pip install -r requirements.txt
 # Edit mcp_agent.secrets.yaml with your API keys and base_url:
 # - openai: api_key, base_url (for OpenAI/custom endpoints)
 # - anthropic: api_key (for Claude models)
+# - google: api_key (for Gemini models)
+
+# 🤖 Select your preferred LLM provider (optional)
+# Edit mcp_agent.config.yaml to choose your LLM (line ~106):
+# - llm_provider: "google"    # Use Google Gemini models
+# - llm_provider: "anthropic" # Use Anthropic Claude models
+# - llm_provider: "openai"    # Use OpenAI/compatible models
+# Note: If not set or unavailable, will automatically fallback to first available provider
 
 # 🔑 Configure search API keys for web search (optional)
 # Edit mcp_agent.config.yaml to set your API keys:
@@ -649,6 +669,14 @@ pip install -r requirements.txt
 # Edit mcp_agent.secrets.yaml with your API keys and base_url:
 # - openai: api_key, base_url (for OpenAI/custom endpoints)
 # - anthropic: api_key (for Claude models)
+# - google: api_key (for Gemini models)
+
+# 🤖 Select your preferred LLM provider (optional)
+# Edit mcp_agent.config.yaml to choose your LLM (line ~106):
+# - llm_provider: "google"    # Use Google Gemini models
+# - llm_provider: "anthropic" # Use Anthropic Claude models
+# - llm_provider: "openai"    # Use OpenAI/compatible models
+# Note: If not set or unavailable, will automatically fallback to first available provider
 
 # 🔑 Configure search API keys for web search (optional)
 # Edit mcp_agent.config.yaml to set your API keys:
@@ -734,28 +762,64 @@ bocha-mcp:
 
 ### ⚡ **Step 2: Launch Application**
 
-#### 🚀 **Using Installed Package (Recommended)**
+#### 🚀 **Using `deepcode` Command (Recommended)**
 
 ```bash
-# 🌐 Launch web interface directly
+# 🌐 Launch the new React-based web interface
 deepcode
 
-# The application will automatically start at http://localhost:8501
+# Frontend: http://localhost:5173
+# Backend API: http://localhost:8000
+# Press Ctrl+C to stop all services
 ```
+<div align="center">
+  <img src="https://img.shields.io/badge/Frontend-localhost:5173-00d4ff?style=flat-square&logo=react&logoColor=white" alt="Frontend" />
+  <img src="https://img.shields.io/badge/Backend-localhost:8000-4ecdc4?style=flat-square&logo=fastapi&logoColor=white" alt="Backend" />
+</div>
+
+> **📦 Auto Install**: On first run, dependencies are automatically installed (`pip install` for backend, `npm install` for frontend)
 
-#### 🛠️ **Using Source Code**
+> **✨ Features**: User-in-Loop interaction, real-time progress tracking, inline chat interaction
 
-Choose your preferred interface:
+#### 🛠️ **Alternative Launch Methods**
+
+<table>
+<tr>
+<td><strong>🍎 macOS / 🐧 Linux</strong></td>
+<td><strong>🪟 Windows</strong></td>
+</tr>
+<tr>
+<td>
 
-##### 🌐 **Web Interface** (Recommended)
 ```bash
-# Using UV
-uv run streamlit run ui/streamlit_app.py
-# Or using traditional Python
-streamlit run ui/streamlit_app.py
+# Using run.sh
+./run.sh
+
+# Or using Python directly
+python deepcode.py
+```
+
+</td>
+<td>
+
+```cmd
+# Using run.bat
+run.bat
+
+# Or using Python directly
+python deepcode.py
+```
+
+</td>
+</tr>
+</table>
+
+```bash
+# Classic Streamlit UI (all platforms)
+deepcode --classic
 ```
 <div align="center">
-  <img src="https://img.shields.io/badge/Access-localhost:8501-00d4ff?style=flat-square&logo=streamlit&logoColor=white" alt="Web Access" />
+  <img src="https://img.shields.io/badge/Classic_UI-localhost:8501-00d4ff?style=flat-square&logo=streamlit&logoColor=white" alt="Classic UI" />
 </div>
 
 ##### 🖥️ **CLI Interface** (Advanced Users)
@@ -900,8 +964,32 @@ We're continuously enhancing DeepCode with exciting new features:
 
 ---
 
+<div align="left">
+
+### 📖 **Citation**
+
+
+If you find DeepCode useful in your research or applications, please kindly cite:
+
+```
+@misc{li2025deepcodeopenagenticcoding,
+      title={DeepCode: Open Agentic Coding},
+      author={Zongwei Li and Zhonghang Li and Zirui Guo and Xubin Ren and Chao Huang},
+      year={2025},
+      eprint={2512.07921},
+      archivePrefix={arXiv},
+      primaryClass={cs.SE},
+      url={https://arxiv.org/abs/2512.07921},
+}
+```
+
+---
+
+
 ### 📄 **License**
 
+<div align="center">
+
 <img src="https://img.shields.io/badge/License-MIT-4ecdc4?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="MIT License">
 
 **MIT License** - Copyright (c) 2025 Data Intelligence Lab, The University of Hong Kong
@@ -909,7 +997,6 @@ We're continuously enhancing DeepCode with exciting new features:
 ---
 
 
-
 <img src="https://visitor-badge.laobi.icu/badge?page_id=deepcode.readme&style=for-the-badge&color=00d4ff" alt="Visitors">
 
 </div>

{deepcode_hku-1.0.7 → deepcode_hku-1.0.9}/__init__.py

@@ -5,7 +5,7 @@ DeepCode - AI Research Engine
 ⚡ Transform research papers into working code automatically
 """
 
-__version__ = "1.0.7"
+__version__ = "1.0.9"
 __author__ = "DeepCode Team"
 __url__ = "https://github.com/HKUDS/DeepCode"