AsyncFuncAI · khengyun · Aug 8, 2025 · Aug 8, 2025 · Aug 8, 2025 · Aug 8, 2025
diff --git a/.gitignore b/.gitignore
@@ -1,7 +1,7 @@
 # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
 # dependencies
-/node_modules
+node_modules/
 /.pnp
 .pnp.*
 .yarn/*
@@ -37,7 +37,7 @@ wheels/
 /coverage
 
 # next.js
-/.next/
+.next/
 /out/
 
 # production

diff --git a/Dockerfile b/Dockerfile
diff --git a/Ollama-instruction.md b/Ollama-instruction.md
@@ -59,12 +59,13 @@ cp api/config/embedder.ollama.json.bak api/config/embedder.json
 
 Start the backend:
 ```bash
-pip install -r api/requirements.txt
-python -m api.main
+pip install -r backend/api/requirements.txt
+cd backend && python -m api.main
 ```
 
 Start the frontend:
 ```bash
+cd frontend
 npm install
 npm run dev
 ```

diff --git a/README.md b/README.md
@@ -14,7 +14,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](./docs/README.md) | [简体中文](./docs/README.zh.md) | [繁體中文](./docs/README.zh-tw.md) | [日本語](./docs/README.ja.md) | [Español](./docs/README.es.md) | [한국어](./docs/README.kr.md) | [Tiếng Việt](./docs/README.vi.md) | [Português Brasileiro](./docs/README.pt-br.md) | [Français](./docs/README.fr.md) | [Русский](./docs/README.ru.md)
 
 ## ✨ Features
 
@@ -81,16 +81,17 @@ OLLAMA_HOST=your_ollama_host
 
 ```bash
 # Install Python dependencies
-pip install -r api/requirements.txt
+pip install -r backend/api/requirements.txt
 
 # Start the API server
-python -m api.main
+cd backend && python -m api.main
 ```
 
 #### Step 3: Start the Frontend
 
 ```bash
 # Install JavaScript dependencies
+cd frontend
 npm install
 # or
 yarn install
@@ -162,21 +163,25 @@ graph TD
 
 ```
 deepwiki/
-├── api/                  # Backend API server
-│   ├── main.py           # API entry point
-│   ├── api.py            # FastAPI implementation
-│   ├── rag.py            # Retrieval Augmented Generation
-│   ├── data_pipeline.py  # Data processing utilities
-│   └── requirements.txt  # Python dependencies
+├── backend/              # Backend API server
+│   ├── api/              # API source code
+│   │   ├── main.py       # API entry point
+│   │   ├── api.py        # FastAPI implementation
+│   │   ├── rag.py        # Retrieval Augmented Generation
+│   │   ├── data_pipeline.py  # Data processing utilities
+│   │   └── requirements.txt  # Python dependencies
+│   └── Dockerfile        # Backend Docker configuration
 │
-├── src/                  # Frontend Next.js app
+├── frontend/             # Frontend Next.js app
 │   ├── app/              # Next.js app directory
-│   │   └── page.tsx      # Main application page
-│   └── components/       # React components
-│       └── Mermaid.tsx   # Mermaid diagram renderer
+│   ├── components/       # React components
+│   ├── lib/              # Utility libraries
+│   ├── public/           # Static assets
+│   ├── package.json      # JavaScript dependencies
+│   └── Dockerfile        # Frontend Docker configuration
 │
-├── public/               # Static assets
-├── package.json          # JavaScript dependencies
+├── docs/                 # Documentation
+├── docker-compose.yml    # Docker Compose configuration
 └── .env                  # Environment variables (create this)
 ```
 
@@ -452,7 +457,7 @@ The API server provides:
 - RAG (Retrieval Augmented Generation)
 - Streaming chat completions
 
-For more details, see the [API README](./api/README.md).
+For more details, see the [API README](./backend/api/README.md).
 
 ## 🔌 OpenRouter Integration
 

diff --git a/.python-version → backend/.python-version b/.python-version → backend/.python-version
diff --git a/backend/Dockerfile b/backend/Dockerfile
@@ -0,0 +1,21 @@
+# backend/Dockerfile
+FROM python:3.11-slim
+WORKDIR /app
+
+# Install curl for health checks
+RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*
+
+# Install Python dependencies
+COPY backend/api/requirements.txt ./api/
+RUN python -m venv /opt/venv && \
+    /opt/venv/bin/pip install --no-cache -r api/requirements.txt
+
+# Copy source
+COPY backend/api/ ./api/
+
+ENV PATH="/opt/venv/bin:$PATH"
+ENV PORT=8001
+
+# Health check endpoint is implemented at /health
+EXPOSE 8001
+CMD ["python", "-m", "api.main"]
diff --git a/api/README.md → backend/api/README.md b/api/README.md → backend/api/README.md
diff --git a/api/__init__.py → backend/api/__init__.py b/api/__init__.py → backend/api/__init__.py
diff --git a/api/api.py → backend/api/api.py b/api/api.py → backend/api/api.py
diff --git a/api/azureai_client.py → backend/api/azureai_client.py b/api/azureai_client.py → backend/api/azureai_client.py
diff --git a/api/bedrock_client.py → backend/api/bedrock_client.py b/api/bedrock_client.py → backend/api/bedrock_client.py
diff --git a/api/config.py → backend/api/config.py b/api/config.py → backend/api/config.py
diff --git a/api/config/embedder.json → backend/api/config/embedder.json b/api/config/embedder.json → backend/api/config/embedder.json
diff --git a/api/config/embedder.json.bak → backend/api/config/embedder.json.bak b/api/config/embedder.json.bak → backend/api/config/embedder.json.bak
diff --git a/api/config/embedder.ollama.json.bak → backend/api/config/embedder.ollama.json.bak b/api/config/embedder.ollama.json.bak → backend/api/config/embedder.ollama.json.bak
diff --git a/...onfig/embedder.openai_compatible.json.bak → ...onfig/embedder.openai_compatible.json.bak b/...onfig/embedder.openai_compatible.json.bak → ...onfig/embedder.openai_compatible.json.bak
diff --git a/api/config/generator.json → backend/api/config/generator.json b/api/config/generator.json → backend/api/config/generator.json
diff --git a/api/config/lang.json → backend/api/config/lang.json b/api/config/lang.json → backend/api/config/lang.json
diff --git a/api/config/repo.json → backend/api/config/repo.json b/api/config/repo.json → backend/api/config/repo.json
diff --git a/api/dashscope_client.py → backend/api/dashscope_client.py b/api/dashscope_client.py → backend/api/dashscope_client.py
diff --git a/api/data_pipeline.py → backend/api/data_pipeline.py b/api/data_pipeline.py → backend/api/data_pipeline.py
diff --git a/api/logging_config.py → backend/api/logging_config.py b/api/logging_config.py → backend/api/logging_config.py
diff --git a/api/main.py → backend/api/main.py b/api/main.py → backend/api/main.py
diff --git a/api/ollama_patch.py → backend/api/ollama_patch.py b/api/ollama_patch.py → backend/api/ollama_patch.py
diff --git a/api/openai_client.py → backend/api/openai_client.py b/api/openai_client.py → backend/api/openai_client.py
diff --git a/api/openrouter_client.py → backend/api/openrouter_client.py b/api/openrouter_client.py → backend/api/openrouter_client.py
diff --git a/api/prompts.py → backend/api/prompts.py b/api/prompts.py → backend/api/prompts.py
diff --git a/api/rag.py → backend/api/rag.py b/api/rag.py → backend/api/rag.py
diff --git a/api/requirements.txt → backend/api/requirements.txt b/api/requirements.txt → backend/api/requirements.txt
diff --git a/api/simple_chat.py → backend/api/simple_chat.py b/api/simple_chat.py → backend/api/simple_chat.py
diff --git a/api/test_api.py → backend/api/test_api.py b/api/test_api.py → backend/api/test_api.py
diff --git a/api/tools/embedder.py → backend/api/tools/embedder.py b/api/tools/embedder.py → backend/api/tools/embedder.py
diff --git a/api/websocket_wiki.py → backend/api/websocket_wiki.py b/api/websocket_wiki.py → backend/api/websocket_wiki.py
diff --git a/pyproject.toml → backend/pyproject.toml b/pyproject.toml → backend/pyproject.toml
diff --git a/pytest.ini → backend/pytest.ini b/pytest.ini → backend/pytest.ini
diff --git a/run.sh → backend/run.sh b/run.sh → backend/run.sh
diff --git a/test/__init__.py → backend/test/__init__.py b/test/__init__.py → backend/test/__init__.py
diff --git a/test/test_extract_repo_name.py → backend/test/test_extract_repo_name.py b/test/test_extract_repo_name.py → backend/test/test_extract_repo_name.py
diff --git a/uv.lock → backend/uv.lock b/uv.lock → backend/uv.lock
diff --git a/docker-compose.yml b/docker-compose.yml
@@ -1,31 +1,38 @@
-version: '3.8'
-
 services:
-  deepwiki:
+  backend:
     build:
       context: .
-      dockerfile: Dockerfile
+      dockerfile: backend/Dockerfile
+    container_name: deepwiki-backend
     ports:
-      - "${PORT:-8001}:${PORT:-8001}"  # API port
-      - "3000:3000"  # Next.js port
+      - "8001:8001"
     env_file:
       - .env
-    environment:
-      - PORT=${PORT:-8001}
-      - NODE_ENV=production
-      - SERVER_BASE_URL=http://localhost:${PORT:-8001}
-      - LOG_LEVEL=${LOG_LEVEL:-INFO}
-      - LOG_FILE_PATH=${LOG_FILE_PATH:-api/logs/application.log}
     volumes:
       - ~/.adalflow:/root/.adalflow      # Persist repository and embedding data
-      - ./api/logs:/app/api/logs          # Persist log files across container restarts
-    # Resource limits for docker-compose up (not Swarm mode)
-    mem_limit: 6g
-    mem_reservation: 2g
-    # Health check configuration
+      - ./backend/api/logs:/app/api/logs # Persist log files across container restarts
     healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:${PORT:-8001}/health"]
-      interval: 60s
-      timeout: 10s
+      test: ["CMD-SHELL", "curl -f http://localhost:8001/health || exit 1"]
+      interval: 30s
+      timeout: 5s
       retries: 3
-      start_period: 30s
+
+  frontend:
+    build:
+      context: .
+      dockerfile: frontend/Dockerfile
+      args:
+        - SERVER_BASE_URL=http://backend:8001
+    container_name: deepwiki-frontend
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+      - SERVER_BASE_URL=http://backend:8001
+    depends_on:
+      backend:
+        condition: service_healthy
+
+networks:
+  default:
+    driver: bridge
diff --git a/README.es.md → docs/README.es.md b/README.es.md → docs/README.es.md
@@ -14,7 +14,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](../README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
 
 ## ✨ Características
 

diff --git a/README.fr.md → docs/README.fr.md b/README.fr.md → docs/README.fr.md
@@ -15,7 +15,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](../README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
 
 ## ✨ Fonctionnalités
 

diff --git a/README.ja.md → docs/README.ja.md b/README.ja.md → docs/README.ja.md
@@ -14,7 +14,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](../README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
 
 ## ✨ 特徴
 

diff --git a/README.kr.md → docs/README.kr.md b/README.kr.md → docs/README.kr.md
@@ -14,7 +14,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](../README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
 
 ## ✨ 주요 기능
 

diff --git a/README.pt-br.md → docs/README.pt-br.md b/README.pt-br.md → docs/README.pt-br.md
@@ -14,7 +14,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](../README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
 
 ## ✨ Recursos
 

diff --git a/README.ru.md → docs/README.ru.md b/README.ru.md → docs/README.ru.md
@@ -14,7 +14,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)  
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](../README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
 
 ## ✨ Возможности
 

diff --git a/README.vi.md → docs/README.vi.md b/README.vi.md → docs/README.vi.md
@@ -14,7 +14,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](../README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
 
 ## ✨ Tính năng
 
@@ -243,7 +243,7 @@ API server cung cấp:
 - RAG (Retrieval Augmented Generation)
 - Trò chuyện liên tục
 
-Biết thêm chi tiết truy cập [ API README](./api/README.md).
+Biết thêm chi tiết truy cập [ API README](../api/README.md).
 
 ## 🤖 Hệ thống lựa chọn mô hình dựa trên nhà cung cấp
 

diff --git a/README.zh-tw.md → docs/README.zh-tw.md b/README.zh-tw.md → docs/README.zh-tw.md
@@ -14,7 +14,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](../README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
 
 ## ✨ 特點
 

diff --git a/README.zh.md → docs/README.zh.md b/README.zh.md → docs/README.zh.md
@@ -14,7 +14,7 @@
 [![Twitter/X](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/sashimikun_void)
 [![Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/VQMBGR8u5v)
 
-[English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
+[English](../README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-tw.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [한국어](./README.kr.md) | [Tiếng Việt](./README.vi.md) | [Português Brasileiro](./README.pt-br.md) | [Français](./README.fr.md) | [Русский](./README.ru.md)
 
 ## ✨ 特点
 

diff --git a/screenshots/DeepResearch.png → docs/screenshots/DeepResearch.png b/screenshots/DeepResearch.png → docs/screenshots/DeepResearch.png
diff --git a/screenshots/Deepwiki.png → docs/screenshots/Deepwiki.png b/screenshots/Deepwiki.png → docs/screenshots/Deepwiki.png
diff --git a/screenshots/Interface.png → docs/screenshots/Interface.png b/screenshots/Interface.png → docs/screenshots/Interface.png
diff --git a/screenshots/Ollama.png → docs/screenshots/Ollama.png b/screenshots/Ollama.png → docs/screenshots/Ollama.png
diff --git a/screenshots/privaterepo.png → docs/screenshots/privaterepo.png b/screenshots/privaterepo.png → docs/screenshots/privaterepo.png