AsyncFuncAI · sng-asyncfunc · Jul 30, 2026 · Jul 18, 2026 · Jul 18, 2026 · Jul 18, 2026
diff --git a/.github/workflows/docker-build-push.yml b/.github/workflows/docker-build-push.yml
@@ -11,13 +11,13 @@ on:
 env:
   REGISTRY: ghcr.io
   IMAGE_NAME: ${{ github.repository }}
-  
+
 concurrency:
   # This concurrency group ensures that only one job in the group runs at a time.
   # If a new job is triggered, the previous one will be canceled.
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
-  
+
 jobs:
   build-and-push:
     strategy:
@@ -39,7 +39,7 @@ jobs:
           platform=${{ matrix.platform }}
           echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
           echo "GHCR_IMAGE=ghcr.io/${GITHUB_REPOSITORY@L}" >> $GITHUB_ENV
-      
+
       - name: Checkout repository
         uses: actions/checkout@v4
 
@@ -75,21 +75,21 @@ jobs:
           outputs: type=image,name=${{ env.GHCR_IMAGE }},push-by-digest=true,name-canonical=true,push=${{ github.event_name != 'pull_request' }},oci-mediatypes=true
           cache-from: type=gha,scope=${{ github.repository }}-${{ github.ref_name }}-${{ matrix.platform }}
           cache-to: type=gha,mode=max,scope=${{ github.repository }}-${{ github.ref_name }}-${{ matrix.platform }}
-          
+
       - name: Export digest
         run: |
           mkdir -p /tmp/digests
           digest="${{ steps.build.outputs.digest }}"
           touch "/tmp/digests/${digest#sha256:}"
 
-      - name: Upload digest 
+      - name: Upload digest
         uses: actions/upload-artifact@v4
         with:
           name: digests-${{ env.PLATFORM_PAIR }}
           path: /tmp/digests/*
           if-no-files-found: error
           retention-days: 1
-  
+
   merge:
     name: merge Docker manifests
     runs-on: ubuntu-latest
@@ -105,7 +105,7 @@ jobs:
         id: prepare
         run: |
           echo "GHCR_IMAGE=ghcr.io/${GITHUB_REPOSITORY@L}" >> $GITHUB_ENV
-      
+
       - name: Download digests
         uses: actions/download-artifact@v4
         with:

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -0,0 +1,71 @@
+# Pre-commit hooks for deepwiki-open (Next.js frontend + FastAPI backend)
+#
+# Setup:
+#   pipx install pre-commit        # or: pip install pre-commit
+#   pre-commit install             # install the git hook
+#   pre-commit run --all-files     # run once across the whole repo
+#
+# Update pinned versions later with:  pre-commit autoupdate
+
+default_language_version:
+  python: python3.12
+
+# Never touch generated / vendored / log / backup files.
+exclude: |
+  (?x)^(
+    .*\.bak|
+    api/logs/.*|
+    .*/__pycache__/.*|
+    public/.*\.svg|
+    yarn\.lock|
+    package-lock\.json|
+    uv\.lock|
+    api/poetry\.lock
+  )$
+
+repos:
+  # ---------------------------------------------------------------------------
+  # General hygiene
+  # ---------------------------------------------------------------------------
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+        args: [--fix=lf]
+      - id: check-merge-conflict
+      - id: check-case-conflict
+      - id: check-added-large-files
+        args: [--maxkb=1024]
+      - id: check-yaml
+      - id: check-toml
+      - id: check-json
+        # .vscode/*.json and tsconfig.json are JSONC (allow comments) -> skip
+        exclude: ^(\.vscode/|tsconfig\.json$)
+      - id: detect-private-key
+
+  # ---------------------------------------------------------------------------
+  # Secret scanning
+  # Blocks commits that contain tokens, keys, or credentials.
+  # ---------------------------------------------------------------------------
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.21.2
+    hooks:
+      - id: gitleaks
+
+  # ---------------------------------------------------------------------------
+  # Python — ruff replaces flake8 + isort + black (lint + format in one tool).
+  # Scoped to the backend and test dirs only.
+  # ---------------------------------------------------------------------------
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.6
+    hooks:
+      - id: ruff
+        name: ruff (lint + autofix)
+        args: [--fix]
+        files: ^(api|test)/.*\.py$  # disable tests folders for now
+      - id: ruff-format
+        name: ruff (format)
+        files: ^(api|test)/.*\.py$
diff --git a/Ollama-instruction.md b/Ollama-instruction.md
@@ -94,7 +94,7 @@ cp api/config/embedder.ollama.json.bak api/config/embedder.json
      -v ~/.adalflow:/root/.adalflow \
      -e OLLAMA_HOST=your_ollama_host \
      deepwiki:ollama-local
-   
+
    # For local repository analysis
    docker run -p 3000:3000 -p 8001:8001 --name deepwiki \
      -v ~/.adalflow:/root/.adalflow \

diff --git a/README.es.md b/README.es.md
@@ -8,6 +8,7 @@
 2. Generará documentación completa
 3. Creará diagramas visuales para explicar cómo funciona todo
 4. Organizará todo en una wiki fácil de navegar
+5. Generará un mapa de código (codemap) para recorridos guiados centrados en el código
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)
 
@@ -289,6 +290,9 @@ Para usar Investigación Profunda, simplemente activa el interruptor "Investigac
 ![Función de Investigación Profunda](screenshots/DeepResearch.png)
 *Investigación Profunda realiza investigaciones de múltiples turnos para temas complejos*
 
+![Codemap](screenshots/Codemap.png)
+*Codemap*
+
 ### Video de Demostración
 
 [![Video de Demostración de DeepWiki](https://img.youtube.com/vi/zGANs8US8B4/0.jpg)](https://youtu.be/zGANs8US8B4)
@@ -331,4 +335,3 @@ Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo [LICEN
 ## ⭐ Historial de Estrellas
 
 [![Gráfico de Historial de Estrellas](https://api.star-history.com/svg?repos=AsyncFuncAI/deepwiki-open&type=Date)](https://star-history.com/#AsyncFuncAI/deepwiki-open&Date)
-
diff --git a/README.fr.md b/README.fr.md
@@ -9,6 +9,7 @@
 2. Génère une documentation complète  
 3. Crée des diagrammes visuels pour expliquer le fonctionnement  
 4. Organise le tout dans un wiki facile à naviguer
+5. Génère une codemap pour des visites guidées centrées sur le code
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)
 [![Tip in Crypto](https://tip.md/badge.svg)](https://tip.md/sng-asyncfunc)
@@ -514,6 +515,9 @@ Pour utiliser DeepResearch, activez simplement le commutateur "Deep Research" da
 ![Fonctionnalité DeepResearch](screenshots/DeepResearch.png)
 *DeepResearch effectue des recherches en plusieurs étapes pour des sujets complexes*
 
+![Codemap](screenshots/Codemap.png)
+*Codemap*
+
 ### Vidéo de démonstration
 
 [![Vidéo de démo DeepWiki](https://img.youtube.com/vi/zGANs8US8B4/0.jpg)](https://youtu.be/zGANs8US8B4)
@@ -560,5 +564,3 @@ Projet sous licence MIT – Voir le fichier [LICENSE](LICENSE).
 ## ⭐ Historique des stars
 
 [![Historique des stars](https://api.star-history.com/svg?repos=AsyncFuncAI/deepwiki-open&type=Date)](https://star-history.com/#AsyncFuncAI/deepwiki-open&Date)
-
-
diff --git a/README.ja.md b/README.ja.md
@@ -8,6 +8,7 @@
 2. 包括的なドキュメントを生成
 3. すべての仕組みを説明する視覚的な図を作成
 4. すべてを簡単に閲覧できる Wiki に整理
+5. コード中心のガイドツアーのためのコードマップを生成
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)
 
@@ -397,6 +398,9 @@ _個人アクセストークンを使用したプライベートリポジトリ
 ![詳細調査機能](screenshots/DeepResearch.png)
 _詳細調査は複雑なトピックに対して多段階の調査を実施_
 
+![Codemap](screenshots/Codemap.png)
+*Codemap*
+
 ### デモビデオ
 
 [![DeepWikiデモビデオ](https://img.youtube.com/vi/zGANs8US8B4/0.jpg)](https://youtu.be/zGANs8US8B4)
@@ -444,4 +448,3 @@ _DeepWiki の動作を見る！_
 ## ⭐ スター履歴
 
 [![スター履歴チャート](https://api.star-history.com/svg?repos=AsyncFuncAI/deepwiki-open&type=Date)](https://star-history.com/#AsyncFuncAI/deepwiki-open&Date)
-
diff --git a/README.kr.md b/README.kr.md
@@ -8,6 +8,7 @@
 2. 포괄적인 문서 생성
 3. 모든 작동 방식을 설명하는 시각적 다이어그램 생성
 4. 이를 쉽게 탐색할 수 있는 위키로 정리
+5. 코드 중심의 가이드 투어를 위한 코드맵 생성
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)
 
@@ -385,6 +386,9 @@ DeepResearch를 사용하려면 질문 제출 전 Ask 인터페이스에서 "Dee
 ![DeepResearch Feature](screenshots/DeepResearch.png)
 *DeepResearch는 복잡한 주제에 대해 다중 턴 조사를 수행*
 
+![Codemap](screenshots/Codemap.png)
+*Codemap*
+
 ### 데모 영상
 
 [![DeepWiki Demo Video](https://img.youtube.com/vi/zGANs8US8B4/0.jpg)](https://youtu.be/zGANs8US8B4)
@@ -427,4 +431,3 @@ DeepResearch를 사용하려면 질문 제출 전 Ask 인터페이스에서 "Dee
 ## ⭐ 스타 히스토리
 
 [![Star History Chart](https://api.star-history.com/svg?repos=AsyncFuncAI/deepwiki-open&type=Date)](https://star-history.com/#AsyncFuncAI/deepwiki-open&Date)
-
diff --git a/README.md b/README.md
@@ -8,6 +8,7 @@
 2. Generate comprehensive documentation
 3. Create visual diagrams to explain how everything works
 4. Organize it all into an easy-to-navigate wiki
+5. Generate codemap for code-centric guided tours
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)
 [![Tip in Crypto](https://tip.md/badge.svg)](https://tip.md/sng-asyncfunc)

diff --git a/README.pt-br.md b/README.pt-br.md
@@ -8,6 +8,7 @@
 2. Gerar documentação abrangente
 3. Criar diagramas visuais para explicar como tudo funciona
 4. Organizar tudo em uma wiki fácil de navegar
+5. Gerar um codemap para tours guiados centrados no código
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)
 [![Tip in Crypto](https://tip.md/badge.svg)](https://tip.md/sng-asyncfunc)
@@ -297,7 +298,7 @@ docker-compose up
 
 | Variável             | Descrição                                                  | Obrigatória | Observação                                                                                                     |
 |----------------------|--------------------------------------------------------------|----------|----------------------------------------------------------------------------------------------------------|
-| `GOOGLE_API_KEY`     | Chave API Google Gemini para geração com IA                      | Não | Necessária apenas se você quiser usar modelos Google Gemini                                                    
+| `GOOGLE_API_KEY`     | Chave API Google Gemini para geração com IA                      | Não | Necessária apenas se você quiser usar modelos Google Gemini  
 | `OPENAI_API_KEY`     | Chave API OpenAI para embeddings                                | Sim | Nota: Isso é necessário mesmo se você não estiver usando modelos OpenAI, pois é usado para embeddings.              |
 | `OPENROUTER_API_KEY` | Chave API OpenRouter para modelos alternativos                    | Não | Necessária apenas se você quiser usar modelos OpenRouter                                                       |
 | `OLLAMA_HOST`        | Host Ollama (padrão: http://localhost:11434)                | Não | Necessária apenas se você quiser usar servidor Ollama externo                                                  |
@@ -466,6 +467,9 @@ Para usar o DeepResearch, simplesmente alterne o interruptor "Pesquisa Aprofunda
 ![Recurso DeepResearch](screenshots/DeepResearch.png)
 *DeepResearch conduz investigações em várias etapas para tópicos complexos*
 
+![Codemap](screenshots/Codemap.png)
+*Codemap*
+
 ### Vídeo de Demonstração
 
 [![Vídeo de Demonstração do DeepWiki](https://img.youtube.com/vi/zGANs8US8B4/0.jpg)](https://youtu.be/zGANs8US8B4)

diff --git a/README.ru.md b/README.ru.md
@@ -8,6 +8,7 @@
 2. Генерацию полноценной документации
 3. Построение визуальных диаграмм, объясняющих работу системы
 4. Организацию всего в удобную и структурированную вики
+5. Создание карты кода (codemap) для пошаговых экскурсий по коду
 
 [!["Купить мне кофе"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)  
 [![Поддержать в криптовалюте](https://tip.md/badge.svg)](https://tip.md/sng-asyncfunc)  
@@ -461,6 +462,9 @@ docker build --build-arg CUSTOM_CERT_DIR=certs .
 ![DeepResearch](screenshots/DeepResearch.png)  
 *DeepResearch анализирует сложные темы*
 
+![Codemap](screenshots/Codemap.png)
+*Codemap*
+
 ### Видео-демо
 
 [![Видео](https://img.youtube.com/vi/zGANs8US8B4/0.jpg)](https://youtu.be/zGANs8US8B4)

diff --git a/README.vi.md b/README.vi.md
@@ -8,6 +8,7 @@
 2. Tạo tài liệu đầy đủ và chi tiết
 3. Tạo sơ đồ trực quan để giải thích cách mọi thứ hoạt động
 4. Sắp xếp tất cả documents thành một wiki dễ hiểu
+5. Tạo codemap cho các chuyến tham quan có hướng dẫn tập trung vào mã nguồn
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)
 
@@ -377,6 +378,9 @@ DeepResearch nâng tầm phân tích kho mã với quy trình nghiện cứu nhi
 ![Tính năng DeepResearch](screenshots/DeepResearch.png)
 *DeepResearch thực hiện nghiện cứu nhiểu vòng cho các chủ đề phức tạp*
 
+![Codemap](screenshots/Codemap.png)
+*Codemap*
+
 ### Demo Video
 
 [![DeepWiki Demo Video](https://img.youtube.com/vi/zGANs8US8B4/0.jpg)](https://youtu.be/zGANs8US8B4)
@@ -420,4 +424,3 @@ Dự án này được cấp phép theo Giấy phép MIT - xem file [LICENSE](LI
 ## ⭐ Lịch sử
 
 [![Biểu đồ lịch sử](https://api.star-history.com/svg?repos=AsyncFuncAI/deepwiki-open&type=Date)](https://star-history.com/#AsyncFuncAI/deepwiki-open&Date)
-
diff --git a/README.zh-tw.md b/README.zh-tw.md
@@ -8,6 +8,7 @@
 2. 產生全面的文件
 3. 建立視覺化圖表解釋一切如何運作
 4. 將所有內容整理成易於導覽的 Wiki
+5. 產生程式碼地圖，提供以程式碼為中心的引導式導覽
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)
 [![Tip in Crypto](https://tip.md/badge.svg)](https://tip.md/sng-asyncfunc)
@@ -304,7 +305,7 @@ docker-compose up
 
 | 變數             | 說明                                                  | 必需 | 備註                                                                                                     |
 |----------------------|--------------------------------------------------------------|----------|----------------------------------------------------------------------------------------------------------|
-| `GOOGLE_API_KEY`     | Google Gemini API 金鑰，用於 AI 產生                      | 否 | 只有在您想使用 Google Gemini 模型時才需要                                                    
+| `GOOGLE_API_KEY`     | Google Gemini API 金鑰，用於 AI 產生                      | 否 | 只有在您想使用 Google Gemini 模型時才需要  
 | `OPENAI_API_KEY`     | OpenAI API 金鑰，用於嵌入                                | 是 | 備註：即使您不使用 OpenAI 模型，這個也是必需的，因為它用於嵌入              |
 | `OPENROUTER_API_KEY` | OpenRouter API 金鑰，用於替代模型                    | 否 | 只有在您想使用 OpenRouter 模型時才需要                                                       |
 | `OLLAMA_HOST`        | Ollama 主機（預設：http://localhost:11434）                | 否 | 只有在您想使用外部 Ollama 伺服器時才需要                                                  |
@@ -466,16 +467,16 @@ OpenRouter 特別適用於以下情況：
 ## 📱 螢幕截圖
 
 ### 主頁面
-![主頁面](screenshots/home.png)
+![主頁面](./screenshots/Interface.png)
 
 ### Wiki 頁面
-![Wiki 頁面](screenshots/wiki-page.png)
-
-### 提問功能
-![提問功能](screenshots/ask.png)
+![Wiki 頁面](screenshots/Deepwiki.png)
 
 ### 深度研究
-![深度研究](screenshots/deep-research.png)
+![深度研究](screenshots/DeepResearch.png)
+
+### Codemap
+![Codemap](screenshots/Codemap.png)
 
 ### 展示影片
 

diff --git a/README.zh.md b/README.zh.md
@@ -8,6 +8,7 @@
 2. 生成全面的文档
 3. 创建可视化图表解释一切如何运作
 4. 将所有内容整理成易于导航的Wiki
+5. 生成代码地图，提供以代码为中心的引导式导览
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sheing)
 
@@ -207,6 +208,9 @@ deepwiki/
 ![深度研究功能](screenshots/DeepResearch.png)
 *深度研究为复杂主题进行多轮调查*
 
+![Codemap](screenshots/Codemap.png)
+*代码地图*
+
 ### 演示视频
 
 [![DeepWiki演示视频](https://img.youtube.com/vi/zGANs8US8B4/0.jpg)](https://youtu.be/zGANs8US8B4)
@@ -382,4 +386,3 @@ OpenAI 客户端的 base_url 配置主要为拥有私有 API 渠道的企业用
 3. 程序会自动用环境变量的值替换 embedder.json 里的占位符。
 
 这样即可无缝切换到 OpenAI 兼容的 embedding 服务，无需修改代码。
-