realtimex-deeptutor 0.5.0.post1__tar.gz → 0.5.0.post3__tar.gz

{realtimex_deeptutor-0.5.0.post1 → realtimex_deeptutor-0.5.0.post3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: realtimex-deeptutor
-Version: 0.5.0.post1
+Version: 0.5.0.post3
 Summary: RealTimeX DeepTutor - Intelligent learning companion with multi-agent collaboration and LightRAG
 License: Apache-2.0
 Requires-Python: >=3.10
@@ -26,6 +26,7 @@ Requires-Dist: lightrag-hku>=1.0.0
 Requires-Dist: PyMuPDF>=1.26.0
 Requires-Dist: numpy<2.0.0,>=1.24.0
 Requires-Dist: arxiv>=2.0.0
+Requires-Dist: realtimex-sdk>=1.1.2
 Provides-Extra: anthropic
 Requires-Dist: anthropic>=0.30.0; extra == "anthropic"
 Provides-Extra: dashscope
@@ -90,8 +91,6 @@ Dynamic: license-file
 ---
 ### 📰 News
 
-> **[2026.1.15]** DeepTutor [v0.5.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) is out! Fixed multiple environment configuration and stability issues. We recommend everyone to pull the latest version! 🎉
-
 > **[2026.1.1]** Happy New Year! Join our [Discord Community](https://discord.gg/zpP9cssj), [Wechat Community](https://github.com/HKUDS/DeepTutor/issues/78), or [Discussions](https://github.com/HKUDS/DeepTutor/discussions) - shape the future of DeepTutor! 💬
 
 > **[2025.12.30]** Visit our [Official Website](https://hkuds.github.io/DeepTutor/) for more details!
@@ -100,10 +99,16 @@ Dynamic: license-file
 
 ### 📦 Releases
 
-> **[2026.1.15]** Release [v0.5.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) - Unified LLM & Embedding services, RAG pipeline selection, and major enhancements to Home, History, QuestionGen & Settings modules -- Thanks to all the contributors!
+> **[2026.1.23]** Release [v0.6.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.6.0) - Frontend session persistence, full Chinese support, Docker deployment updates, and minor bug fixes -- Thanks for all the feedback!
+
 <details>
 <summary>History releases</summary>
 
+> **[2026.1.18]** Release [v0.5.2](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.1) - Enhance RAG pipeline with Docling support and improve CI/CD workflows with several minor bugs fixed -- Thanks to all the feedbacks!
+
+
+> **[2026.1.15]** Release [v0.5.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) - Unified LLM & Embedding services, RAG pipeline selection, and major enhancements to Home, History, QuestionGen & Settings modules -- Thanks to all the contributors!
+
 > **[2026.1.9]** Release [v0.4.1](https://github.com/HKUDS/DeepTutor/releases/tag/v0.4.1) with LLM Provider system overhaul, Question Generation robustness improvements, and codebase cleanup - Thanks to all the contributors!
 
 > **[2026.1.9]** Release [v0.4.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.4.0) with new code structure, multiple llm & embeddings support - Thanks to all the contributors!
@@ -390,14 +395,14 @@ cp .env.example .env
 **Quick Start** — Build from source:
 
 ```bash
-docker compose up --build -d    # Build and start (~5-10 min first run)
-docker compose logs -f          # View logs
+docker compose up                  # Build and start (~11 min first run on mac mini M4)
+docker compose build --no-cache    # Clear cache and rebuild after pull the newest repo
 ```
 
 **Or use pre-built image** (faster):
 
 ```bash
-# Linux/macOS (AMD64)
+# Works on all platforms - Docker auto-detects your architecture
 docker run -d --name deeptutor \
   -p 8001:8001 -p 3782:3782 \
   --env-file .env \
@@ -405,7 +410,6 @@ docker run -d --name deeptutor \
   -v $(pwd)/config:/app/config:ro \
   ghcr.io/hkuds/deeptutor:latest
 
-# Apple Silicon (ARM64): use ghcr.io/hkuds/deeptutor:latest-arm64
 # Windows PowerShell: use ${PWD} instead of $(pwd)
 ```
 
@@ -421,14 +425,16 @@ docker compose up --build # Rebuild after changes
 <details>
 <summary>📋 <b>More Docker Options</b> (Pre-built images, Cloud deployment, Custom ports)</summary>
 
-**Pre-built Image Architecture Reference:**
+**Pre-built Image Tags:**
 
-| Architecture | Image Tag | Use Case |
-|:-------------|:----------|:---------|
-| **AMD64** | `ghcr.io/hkuds/deeptutor:latest` | Intel/AMD (most servers, Windows/Linux PCs) |
-| **ARM64** | `ghcr.io/hkuds/deeptutor:latest-arm64` | Apple Silicon, AWS Graviton, Raspberry Pi |
+| Tag | Architectures | Description |
+|:----|:--------------|:------------|
+| `:latest` | AMD64 + ARM64 | Latest stable release (auto-detects your architecture) |
+| `:v0.5.x` | AMD64 + ARM64 | Specific version (auto-detects your architecture) |
+| `:v0.5.x-amd64` | AMD64 only | Explicit AMD64 image |
+| `:v0.5.x-arm64` | ARM64 only | Explicit ARM64 image |
 
-> 💡 Run `uname -m` to check: `x86_64` = AMD64, `arm64`/`aarch64` = ARM64
+> 💡 The `:latest` tag is a **multi-architecture image** — Docker automatically pulls the correct version for your system (Intel/AMD or Apple Silicon/ARM)
 
 **Cloud Deployment** — Must set external API URL:
 
@@ -1605,8 +1611,9 @@ We hope DeepTutor could become a gift for the community. 🎁
 
 This project is licensed under the ***[AGPL-3.0 License](LICENSE)***.
 
-*✨ Thanks for visiting **DeepTutor**!*
-
-<img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.DeepTutor&style=for-the-badge&color=00d4ff" alt="Views">
+<p align="center">
+  <em> Thanks for visiting ✨ DeepTutor!</em><br><br>
+  <img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.DeepTutor&style=for-the-badge&color=00d4ff" alt="Views">
+</p>
 
 </div>

{realtimex_deeptutor-0.5.0.post1 → realtimex_deeptutor-0.5.0.post3}/README.md

@@ -37,8 +37,6 @@
 ---
 ### 📰 News
 
-> **[2026.1.15]** DeepTutor [v0.5.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) is out! Fixed multiple environment configuration and stability issues. We recommend everyone to pull the latest version! 🎉
-
 > **[2026.1.1]** Happy New Year! Join our [Discord Community](https://discord.gg/zpP9cssj), [Wechat Community](https://github.com/HKUDS/DeepTutor/issues/78), or [Discussions](https://github.com/HKUDS/DeepTutor/discussions) - shape the future of DeepTutor! 💬
 
 > **[2025.12.30]** Visit our [Official Website](https://hkuds.github.io/DeepTutor/) for more details!
@@ -47,10 +45,16 @@
 
 ### 📦 Releases
 
-> **[2026.1.15]** Release [v0.5.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) - Unified LLM & Embedding services, RAG pipeline selection, and major enhancements to Home, History, QuestionGen & Settings modules -- Thanks to all the contributors!
+> **[2026.1.23]** Release [v0.6.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.6.0) - Frontend session persistence, full Chinese support, Docker deployment updates, and minor bug fixes -- Thanks for all the feedback!
+
 <details>
 <summary>History releases</summary>
 
+> **[2026.1.18]** Release [v0.5.2](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.1) - Enhance RAG pipeline with Docling support and improve CI/CD workflows with several minor bugs fixed -- Thanks to all the feedbacks!
+
+
+> **[2026.1.15]** Release [v0.5.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) - Unified LLM & Embedding services, RAG pipeline selection, and major enhancements to Home, History, QuestionGen & Settings modules -- Thanks to all the contributors!
+
 > **[2026.1.9]** Release [v0.4.1](https://github.com/HKUDS/DeepTutor/releases/tag/v0.4.1) with LLM Provider system overhaul, Question Generation robustness improvements, and codebase cleanup - Thanks to all the contributors!
 
 > **[2026.1.9]** Release [v0.4.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.4.0) with new code structure, multiple llm & embeddings support - Thanks to all the contributors!
@@ -337,14 +341,14 @@ cp .env.example .env
 **Quick Start** — Build from source:
 
 ```bash
-docker compose up --build -d    # Build and start (~5-10 min first run)
-docker compose logs -f          # View logs
+docker compose up                  # Build and start (~11 min first run on mac mini M4)
+docker compose build --no-cache    # Clear cache and rebuild after pull the newest repo
 ```
 
 **Or use pre-built image** (faster):
 
 ```bash
-# Linux/macOS (AMD64)
+# Works on all platforms - Docker auto-detects your architecture
 docker run -d --name deeptutor \
   -p 8001:8001 -p 3782:3782 \
   --env-file .env \
@@ -352,7 +356,6 @@ docker run -d --name deeptutor \
   -v $(pwd)/config:/app/config:ro \
   ghcr.io/hkuds/deeptutor:latest
 
-# Apple Silicon (ARM64): use ghcr.io/hkuds/deeptutor:latest-arm64
 # Windows PowerShell: use ${PWD} instead of $(pwd)
 ```
 
@@ -368,14 +371,16 @@ docker compose up --build # Rebuild after changes
 <details>
 <summary>📋 <b>More Docker Options</b> (Pre-built images, Cloud deployment, Custom ports)</summary>
 
-**Pre-built Image Architecture Reference:**
+**Pre-built Image Tags:**
 
-| Architecture | Image Tag | Use Case |
-|:-------------|:----------|:---------|
-| **AMD64** | `ghcr.io/hkuds/deeptutor:latest` | Intel/AMD (most servers, Windows/Linux PCs) |
-| **ARM64** | `ghcr.io/hkuds/deeptutor:latest-arm64` | Apple Silicon, AWS Graviton, Raspberry Pi |
+| Tag | Architectures | Description |
+|:----|:--------------|:------------|
+| `:latest` | AMD64 + ARM64 | Latest stable release (auto-detects your architecture) |
+| `:v0.5.x` | AMD64 + ARM64 | Specific version (auto-detects your architecture) |
+| `:v0.5.x-amd64` | AMD64 only | Explicit AMD64 image |
+| `:v0.5.x-arm64` | ARM64 only | Explicit ARM64 image |
 
-> 💡 Run `uname -m` to check: `x86_64` = AMD64, `arm64`/`aarch64` = ARM64
+> 💡 The `:latest` tag is a **multi-architecture image** — Docker automatically pulls the correct version for your system (Intel/AMD or Apple Silicon/ARM)
 
 **Cloud Deployment** — Must set external API URL:
 
@@ -1552,8 +1557,9 @@ We hope DeepTutor could become a gift for the community. 🎁
 
 This project is licensed under the ***[AGPL-3.0 License](LICENSE)***.
 
-*✨ Thanks for visiting **DeepTutor**!*
-
-<img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.DeepTutor&style=for-the-badge&color=00d4ff" alt="Views">
+<p align="center">
+  <em> Thanks for visiting ✨ DeepTutor!</em><br><br>
+  <img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.DeepTutor&style=for-the-badge&color=00d4ff" alt="Views">
+</p>
 
 </div>

{realtimex_deeptutor-0.5.0.post1 → realtimex_deeptutor-0.5.0.post3}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "realtimex-deeptutor"
-version = "0.5.0.post1"
+version = "0.5.0.post3"
 description = "RealTimeX DeepTutor - Intelligent learning companion with multi-agent collaboration and LightRAG"
 requires-python = ">=3.10"
 readme = "README.md"
@@ -43,6 +43,8 @@ dependencies = [
     "numpy>=1.24.0,<2.0.0",
     # Academic and research tools
     "arxiv>=2.0.0",
+    # RealTimeX SDK
+    "realtimex-sdk>=1.1.2",
 ]
 
 # Optional dependencies for different providers and features
@@ -79,11 +81,16 @@ dev = [
 ]
 
 [project.scripts]
-deeptutor = "src.api.run_server:main"
+# Main entry point for full-stack startup (uvx realtimex-deeptutor)
+realtimex-deeptutor = "src.cli.start:main"
+deeptutor = "src.cli.start:main"  # Shorter alias
+
+# Backend-only mode (existing, for advanced users)
+deeptutor-backend = "src.api.run_server:main"
 
 [tool.setuptools.packages.find]
 where = ["."]
-include = ["src*", "realtimex_deeptutor*"]
+include = ["src*", "realtimex_deeptutor*", "scripts*"]
 
 [tool.setuptools.package-data]
 # Include non-Python files in the package distribution
@@ -231,7 +238,8 @@ split-on-trailing-comma = true
 # ============================================
 [tool.ruff.lint.per-file-ignores]
 # Allow longer lines in test files
-"**/test_*.py" = ["E501", "PLR2004"]
+# F401: Allow unused imports for availability checks in tests
+"**/test_*.py" = ["E501", "PLR2004", "F401"]
 "**/__init__.py" = ["F401"]  # Allow unused imports in __init__.py
 
 # ============================================

{realtimex_deeptutor-0.5.0.post1 → realtimex_deeptutor-0.5.0.post3}/realtimex_deeptutor.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: realtimex-deeptutor
-Version: 0.5.0.post1
+Version: 0.5.0.post3
 Summary: RealTimeX DeepTutor - Intelligent learning companion with multi-agent collaboration and LightRAG
 License: Apache-2.0
 Requires-Python: >=3.10
@@ -26,6 +26,7 @@ Requires-Dist: lightrag-hku>=1.0.0
 Requires-Dist: PyMuPDF>=1.26.0
 Requires-Dist: numpy<2.0.0,>=1.24.0
 Requires-Dist: arxiv>=2.0.0
+Requires-Dist: realtimex-sdk>=1.1.2
 Provides-Extra: anthropic
 Requires-Dist: anthropic>=0.30.0; extra == "anthropic"
 Provides-Extra: dashscope
@@ -90,8 +91,6 @@ Dynamic: license-file
 ---
 ### 📰 News
 
-> **[2026.1.15]** DeepTutor [v0.5.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) is out! Fixed multiple environment configuration and stability issues. We recommend everyone to pull the latest version! 🎉
-
 > **[2026.1.1]** Happy New Year! Join our [Discord Community](https://discord.gg/zpP9cssj), [Wechat Community](https://github.com/HKUDS/DeepTutor/issues/78), or [Discussions](https://github.com/HKUDS/DeepTutor/discussions) - shape the future of DeepTutor! 💬
 
 > **[2025.12.30]** Visit our [Official Website](https://hkuds.github.io/DeepTutor/) for more details!
@@ -100,10 +99,16 @@ Dynamic: license-file
 
 ### 📦 Releases
 
-> **[2026.1.15]** Release [v0.5.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) - Unified LLM & Embedding services, RAG pipeline selection, and major enhancements to Home, History, QuestionGen & Settings modules -- Thanks to all the contributors!
+> **[2026.1.23]** Release [v0.6.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.6.0) - Frontend session persistence, full Chinese support, Docker deployment updates, and minor bug fixes -- Thanks for all the feedback!
+
 <details>
 <summary>History releases</summary>
 
+> **[2026.1.18]** Release [v0.5.2](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.1) - Enhance RAG pipeline with Docling support and improve CI/CD workflows with several minor bugs fixed -- Thanks to all the feedbacks!
+
+
+> **[2026.1.15]** Release [v0.5.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) - Unified LLM & Embedding services, RAG pipeline selection, and major enhancements to Home, History, QuestionGen & Settings modules -- Thanks to all the contributors!
+
 > **[2026.1.9]** Release [v0.4.1](https://github.com/HKUDS/DeepTutor/releases/tag/v0.4.1) with LLM Provider system overhaul, Question Generation robustness improvements, and codebase cleanup - Thanks to all the contributors!
 
 > **[2026.1.9]** Release [v0.4.0](https://github.com/HKUDS/DeepTutor/releases/tag/v0.4.0) with new code structure, multiple llm & embeddings support - Thanks to all the contributors!
@@ -390,14 +395,14 @@ cp .env.example .env
 **Quick Start** — Build from source:
 
 ```bash
-docker compose up --build -d    # Build and start (~5-10 min first run)
-docker compose logs -f          # View logs
+docker compose up                  # Build and start (~11 min first run on mac mini M4)
+docker compose build --no-cache    # Clear cache and rebuild after pull the newest repo
 ```
 
 **Or use pre-built image** (faster):
 
 ```bash
-# Linux/macOS (AMD64)
+# Works on all platforms - Docker auto-detects your architecture
 docker run -d --name deeptutor \
   -p 8001:8001 -p 3782:3782 \
   --env-file .env \
@@ -405,7 +410,6 @@ docker run -d --name deeptutor \
   -v $(pwd)/config:/app/config:ro \
   ghcr.io/hkuds/deeptutor:latest
 
-# Apple Silicon (ARM64): use ghcr.io/hkuds/deeptutor:latest-arm64
 # Windows PowerShell: use ${PWD} instead of $(pwd)
 ```
 
@@ -421,14 +425,16 @@ docker compose up --build # Rebuild after changes
 <details>
 <summary>📋 <b>More Docker Options</b> (Pre-built images, Cloud deployment, Custom ports)</summary>
 
-**Pre-built Image Architecture Reference:**
+**Pre-built Image Tags:**
 
-| Architecture | Image Tag | Use Case |
-|:-------------|:----------|:---------|
-| **AMD64** | `ghcr.io/hkuds/deeptutor:latest` | Intel/AMD (most servers, Windows/Linux PCs) |
-| **ARM64** | `ghcr.io/hkuds/deeptutor:latest-arm64` | Apple Silicon, AWS Graviton, Raspberry Pi |
+| Tag | Architectures | Description |
+|:----|:--------------|:------------|
+| `:latest` | AMD64 + ARM64 | Latest stable release (auto-detects your architecture) |
+| `:v0.5.x` | AMD64 + ARM64 | Specific version (auto-detects your architecture) |
+| `:v0.5.x-amd64` | AMD64 only | Explicit AMD64 image |
+| `:v0.5.x-arm64` | ARM64 only | Explicit ARM64 image |
 
-> 💡 Run `uname -m` to check: `x86_64` = AMD64, `arm64`/`aarch64` = ARM64
+> 💡 The `:latest` tag is a **multi-architecture image** — Docker automatically pulls the correct version for your system (Intel/AMD or Apple Silicon/ARM)
 
 **Cloud Deployment** — Must set external API URL:
 
@@ -1605,8 +1611,9 @@ We hope DeepTutor could become a gift for the community. 🎁
 
 This project is licensed under the ***[AGPL-3.0 License](LICENSE)***.
 
-*✨ Thanks for visiting **DeepTutor**!*
-
-<img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.DeepTutor&style=for-the-badge&color=00d4ff" alt="Views">
+<p align="center">
+  <em> Thanks for visiting ✨ DeepTutor!</em><br><br>
+  <img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.DeepTutor&style=for-the-badge&color=00d4ff" alt="Views">
+</p>
 
 </div>

{realtimex_deeptutor-0.5.0.post1 → realtimex_deeptutor-0.5.0.post3}/realtimex_deeptutor.egg-info/SOURCES.txt

@@ -8,6 +8,15 @@ realtimex_deeptutor.egg-info/dependency_links.txt
 realtimex_deeptutor.egg-info/entry_points.txt
 realtimex_deeptutor.egg-info/requires.txt
 realtimex_deeptutor.egg-info/top_level.txt
+scripts/__init__.py
+scripts/audit_prompts.py
+scripts/check_install.py
+scripts/generate_roster.py
+scripts/install_all.py
+scripts/migrate_kb.py
+scripts/start.py
+scripts/start_web.py
+scripts/sync_prompts_from_en.py
 src/__init__.py
 src/agents/__init__.py
 src/agents/base_agent.py
@@ -88,6 +97,7 @@ src/agents/research/utils/json_utils.py
 src/agents/research/utils/token_tracker.py
 src/agents/solve/__init__.py
 src/agents/solve/main_solver.py
+src/agents/solve/session_manager.py
 src/agents/solve/analysis_loop/__init__.py
 src/agents/solve/analysis_loop/investigate_agent.py
 src/agents/solve/analysis_loop/note_agent.py
@@ -137,6 +147,7 @@ src/api/routers/ideagen.py
 src/api/routers/knowledge.py
 src/api/routers/notebook.py
 src/api/routers/question.py
+src/api/routers/realtimex.py
 src/api/routers/research.py
 src/api/routers/settings.py
 src/api/routers/solve.py
@@ -146,6 +157,8 @@ src/api/utils/log_interceptor.py
 src/api/utils/notebook_manager.py
 src/api/utils/progress_broadcaster.py
 src/api/utils/task_id_manager.py
+src/cli/__init__.py
+src/cli/start.py
 src/config/__init__.py
 src/config/accessors.py
 src/config/constants.py
@@ -190,6 +203,7 @@ src/services/embedding/adapters/cohere.py
 src/services/embedding/adapters/jina.py
 src/services/embedding/adapters/ollama.py
 src/services/embedding/adapters/openai_compatible.py
+src/services/embedding/adapters/realtimex.py
 src/services/llm/__init__.py
 src/services/llm/capabilities.py
 src/services/llm/client.py
@@ -199,6 +213,7 @@ src/services/llm/error_mapping.py
 src/services/llm/exceptions.py
 src/services/llm/factory.py
 src/services/llm/local_provider.py
+src/services/llm/realtimex_provider.py
 src/services/llm/registry.py
 src/services/llm/telemetry.py
 src/services/llm/types.py
@@ -240,10 +255,12 @@ src/services/rag/components/retrievers/dense.py
 src/services/rag/components/retrievers/hybrid.py
 src/services/rag/components/retrievers/lightrag.py
 src/services/rag/pipelines/__init__.py
-src/services/rag/pipelines/academic.py
 src/services/rag/pipelines/lightrag.py
 src/services/rag/pipelines/llamaindex.py
 src/services/rag/pipelines/raganything.py
+src/services/rag/pipelines/raganything_docling.py
+src/services/rag/utils/__init__.py
+src/services/rag/utils/image_migration.py
 src/services/search/__init__.py
 src/services/search/base.py
 src/services/search/consolidation.py
@@ -255,6 +272,8 @@ src/services/search/providers/jina.py
 src/services/search/providers/perplexity.py
 src/services/search/providers/serper.py
 src/services/search/providers/tavily.py
+src/services/settings/__init__.py
+src/services/settings/interface_settings.py
 src/services/setup/__init__.py
 src/services/setup/init.py
 src/services/tts/__init__.py
@@ -276,4 +295,5 @@ src/utils/document_validator.py
 src/utils/error_rate_tracker.py
 src/utils/error_utils.py
 src/utils/json_parser.py
+src/utils/realtimex.py
 src/utils/network/circuit_breaker.py

realtimex_deeptutor-0.5.0.post3/realtimex_deeptutor.egg-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+deeptutor = src.cli.start:main
+deeptutor-backend = src.api.run_server:main
+realtimex-deeptutor = src.cli.start:main

{realtimex_deeptutor-0.5.0.post1 → realtimex_deeptutor-0.5.0.post3}/realtimex_deeptutor.egg-info/requires.txt

@@ -18,6 +18,7 @@ lightrag-hku>=1.0.0
 PyMuPDF>=1.26.0
 numpy<2.0.0,>=1.24.0
 arxiv>=2.0.0
+realtimex-sdk>=1.1.2
 
 [academic]
 arxiv>=2.0.0

{realtimex_deeptutor-0.5.0.post1 → realtimex_deeptutor-0.5.0.post3}/realtimex_deeptutor.egg-info/top_level.txt

@@ -1,2 +1,3 @@
 realtimex_deeptutor
+scripts
 src

realtimex_deeptutor-0.5.0.post3/scripts/__init__.py

@@ -0,0 +1 @@
+# Scripts package - included for package distribution

realtimex_deeptutor-0.5.0.post3/scripts/audit_prompts.py

@@ -0,0 +1,179 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+Audit prompt parity between prompts/en and prompts/zh|prompts/cn.
+
+Checks:
+- Missing/extra keys (recursive)
+- Placeholder drift in string templates (e.g. {question}, {context})
+
+Usage:
+  python scripts/audit_prompts.py
+  python scripts/audit_prompts.py --fail
+"""
+
+from __future__ import annotations
+
+import argparse
+from dataclasses import dataclass
+from pathlib import Path
+import re
+import sys
+from typing import Any, Iterable
+
+import yaml
+
+PROJECT_ROOT = Path(__file__).resolve().parents[1]
+AGENTS_DIR = PROJECT_ROOT / "src" / "agents"
+
+# Template placeholders are expected to be like {topic}, {knowledge_title}, etc.
+# Avoid false positives from LaTeX (\frac{1}{3}) and Mermaid (B{{Processing}}).
+PLACEHOLDER_RE = re.compile(r"(?<!\{)\{[A-Za-z_][A-Za-z0-9_]*\}(?!\})")
+
+
+def _load_yaml(path: Path) -> Any:
+    with open(path, encoding="utf-8") as f:
+        return yaml.safe_load(f) or {}
+
+
+def _iter_yaml_files(root: Path) -> Iterable[Path]:
+    if not root.exists():
+        return []
+    return sorted([p for p in root.rglob("*.yaml") if p.is_file()])
+
+
+def _get_placeholders(value: Any) -> set[str]:
+    found: set[str] = set()
+    if isinstance(value, str):
+        found |= set(PLACEHOLDER_RE.findall(value))
+    elif isinstance(value, dict):
+        for v in value.values():
+            found |= _get_placeholders(v)
+    elif isinstance(value, list):
+        for v in value:
+            found |= _get_placeholders(v)
+    return found
+
+
+def _collect_keys(value: Any, prefix: str = "") -> set[str]:
+    """
+    Collect dotted key paths for all dict nodes.
+    Leaves (non-dict) are also included as paths.
+    """
+    keys: set[str] = set()
+    if isinstance(value, dict):
+        for k, v in value.items():
+            path = f"{prefix}.{k}" if prefix else str(k)
+            keys.add(path)
+            keys |= _collect_keys(v, path)
+    elif isinstance(value, list):
+        # Lists: we don't expand indices; still consider it a leaf container.
+        if prefix:
+            keys.add(prefix)
+    else:
+        if prefix:
+            keys.add(prefix)
+    return keys
+
+
+@dataclass
+class Diff:
+    missing_zh: list[str]
+    extra_zh: list[str]
+    placeholder_missing_zh: list[str]
+    placeholder_extra_zh: list[str]
+
+
+def _diff(en_obj: Any, zh_obj: Any) -> Diff:
+    en_keys = _collect_keys(en_obj)
+    zh_keys = _collect_keys(zh_obj)
+
+    en_ph = _get_placeholders(en_obj)
+    zh_ph = _get_placeholders(zh_obj)
+
+    return Diff(
+        missing_zh=sorted(en_keys - zh_keys),
+        extra_zh=sorted(zh_keys - en_keys),
+        placeholder_missing_zh=sorted(en_ph - zh_ph),
+        placeholder_extra_zh=sorted(zh_ph - en_ph),
+    )
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--fail", action="store_true", help="exit non-zero on any issue")
+    args = parser.parse_args()
+
+    if not AGENTS_DIR.exists():
+        print(f"Agents directory not found: {AGENTS_DIR}", file=sys.stderr)
+        return 2
+
+    issues = 0
+
+    for module_dir in sorted([p for p in AGENTS_DIR.iterdir() if p.is_dir()]):
+        prompts_dir = module_dir / "prompts"
+        en_dir = prompts_dir / "en"
+        if not en_dir.exists():
+            continue
+
+        # Prefer zh if exists, else cn if exists (but we also compare against cn if present)
+        zh_dir = prompts_dir / "zh"
+        cn_dir = prompts_dir / "cn"
+
+        for en_file in _iter_yaml_files(en_dir):
+            rel = en_file.relative_to(en_dir)
+            candidates = []
+            if zh_dir.exists():
+                candidates.append(("zh", zh_dir / rel))
+            if cn_dir.exists():
+                candidates.append(("cn", cn_dir / rel))
+
+            if not candidates:
+                continue
+
+            en_obj = _load_yaml(en_file)
+
+            for lang_name, zh_file in candidates:
+                if not zh_file.exists():
+                    issues += 1
+                    print(f"[MISSING {lang_name}] {module_dir.name}: {rel.as_posix()}")
+                    continue
+
+                zh_obj = _load_yaml(zh_file)
+                d = _diff(en_obj, zh_obj)
+
+                if d.missing_zh or d.extra_zh or d.placeholder_missing_zh or d.placeholder_extra_zh:
+                    issues += 1
+                    print(f"[DIFF {lang_name}] {module_dir.name}: {rel.as_posix()}")
+                    if d.missing_zh:
+                        print("  - missing keys:")
+                        for k in d.missing_zh[:50]:
+                            print(f"    - {k}")
+                        if len(d.missing_zh) > 50:
+                            print(f"    ... ({len(d.missing_zh) - 50} more)")
+                    if d.extra_zh:
+                        print("  - extra keys:")
+                        for k in d.extra_zh[:50]:
+                            print(f"    - {k}")
+                        if len(d.extra_zh) > 50:
+                            print(f"    ... ({len(d.extra_zh) - 50} more)")
+                    if d.placeholder_missing_zh:
+                        print("  - missing placeholders:")
+                        for p in d.placeholder_missing_zh:
+                            print(f"    - {p}")
+                    if d.placeholder_extra_zh:
+                        print("  - extra placeholders:")
+                        for p in d.placeholder_extra_zh:
+                            print(f"    - {p}")
+
+    if issues == 0:
+        print("OK: prompts are structurally aligned (keys/placeholders).")
+        return 0
+
+    print(f"Found {issues} prompt parity issue(s).")
+    return 1 if args.fail else 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())