sirchmunk 0.0.1__tar.gz → 0.0.2__tar.gz

{sirchmunk-0.0.1 → sirchmunk-0.0.2}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: sirchmunk
-Version: 0.0.1
+Version: 0.0.2
 Summary: Sirchmunk: From raw data to self-evolving real-time intelligence.
-Home-page: https://github.com/modelscope/sirchmunk
 Author: ModelScope Team
 Author-email: contact@modelscope.cn
 License: Apache License 2.0
 Project-URL: Homepage, https://github.com/modelscope/sirchmunk
-Keywords: LLM,Agentic,Search,RAG,Indexless,Self-evolving,Real-time Intelligence,Multi-modal
+Keywords: LLM,Agentic Search,Embedding-Free,RAG,Indexless,Self-evolving,Real-time Intelligence,Multi-modal
 Classifier: Development Status :: 4 - Beta
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -35,6 +34,21 @@ Requires-Dist: tqdm
 Requires-Dist: rapidfuzz
 Requires-Dist: duckdb
 Requires-Dist: kreuzberg>=4.0.0rc1
+Requires-Dist: sentence-transformers
+Requires-Dist: modelscope
+Provides-Extra: web
+Requires-Dist: fastapi>=0.100.0; extra == "web"
+Requires-Dist: uvicorn[standard]>=0.24.0; extra == "web"
+Requires-Dist: websockets>=12.0; extra == "web"
+Requires-Dist: python-multipart>=0.0.6; extra == "web"
+Requires-Dist: pydantic>=2.0.0; extra == "web"
+Requires-Dist: requests>=2.32.2; extra == "web"
+Requires-Dist: aiohttp>=3.9.4; extra == "web"
+Requires-Dist: httpx>=0.27.0; extra == "web"
+Requires-Dist: urllib3>=2.2.1; extra == "web"
+Requires-Dist: pydantic>=2.0; extra == "web"
+Requires-Dist: python-dotenv>=1.0.0; extra == "web"
+Requires-Dist: psutil; extra == "web"
 Provides-Extra: docs
 Requires-Dist: docutils>=0.16.0; extra == "docs"
 Requires-Dist: myst_parser; extra == "docs"
@@ -49,34 +63,19 @@ Requires-Dist: sphinxcontrib-mermaid; extra == "docs"
 Provides-Extra: tests
 Requires-Dist: pytest; extra == "tests"
 Requires-Dist: pytest-asyncio; extra == "tests"
-Provides-Extra: web
-Requires-Dist: fastapi>=0.100.0; extra == "web"
-Requires-Dist: uvicorn[standard]>=0.24.0; extra == "web"
-Requires-Dist: websockets>=12.0; extra == "web"
-Requires-Dist: python-multipart>=0.0.6; extra == "web"
-Requires-Dist: pydantic>=2.0.0; extra == "web"
-Requires-Dist: requests>=2.32.2; extra == "web"
-Requires-Dist: aiohttp>=3.9.4; extra == "web"
-Requires-Dist: urllib3>=2.2.1; extra == "web"
-Requires-Dist: pydantic>=2.0; extra == "web"
-Requires-Dist: python-dotenv>=1.0.0; extra == "web"
-Requires-Dist: psutil; extra == "web"
 Provides-Extra: all
-Requires-Dist: loguru; extra == "all"
-Requires-Dist: fastapi; extra == "all"
-Requires-Dist: openai; extra == "all"
-Requires-Dist: genson; extra == "all"
-Requires-Dist: pillow; extra == "all"
-Requires-Dist: pypdf; extra == "all"
-Requires-Dist: pandas; extra == "all"
-Requires-Dist: parquet; extra == "all"
-Requires-Dist: numpy; extra == "all"
-Requires-Dist: msgpack; extra == "all"
-Requires-Dist: sentencepiece; extra == "all"
-Requires-Dist: tqdm; extra == "all"
-Requires-Dist: rapidfuzz; extra == "all"
-Requires-Dist: duckdb; extra == "all"
-Requires-Dist: kreuzberg>=4.0.0rc1; extra == "all"
+Requires-Dist: fastapi>=0.100.0; extra == "all"
+Requires-Dist: uvicorn[standard]>=0.24.0; extra == "all"
+Requires-Dist: websockets>=12.0; extra == "all"
+Requires-Dist: python-multipart>=0.0.6; extra == "all"
+Requires-Dist: pydantic>=2.0.0; extra == "all"
+Requires-Dist: requests>=2.32.2; extra == "all"
+Requires-Dist: aiohttp>=3.9.4; extra == "all"
+Requires-Dist: httpx>=0.27.0; extra == "all"
+Requires-Dist: urllib3>=2.2.1; extra == "all"
+Requires-Dist: pydantic>=2.0; extra == "all"
+Requires-Dist: python-dotenv>=1.0.0; extra == "all"
+Requires-Dist: psutil; extra == "all"
 Requires-Dist: docutils>=0.16.0; extra == "all"
 Requires-Dist: myst_parser; extra == "all"
 Requires-Dist: recommonmark; extra == "all"
@@ -89,21 +88,7 @@ Requires-Dist: sphinxawesome-theme; extra == "all"
 Requires-Dist: sphinxcontrib-mermaid; extra == "all"
 Requires-Dist: pytest; extra == "all"
 Requires-Dist: pytest-asyncio; extra == "all"
-Requires-Dist: fastapi>=0.100.0; extra == "all"
-Requires-Dist: uvicorn[standard]>=0.24.0; extra == "all"
-Requires-Dist: websockets>=12.0; extra == "all"
-Requires-Dist: python-multipart>=0.0.6; extra == "all"
-Requires-Dist: pydantic>=2.0.0; extra == "all"
-Requires-Dist: requests>=2.32.2; extra == "all"
-Requires-Dist: aiohttp>=3.9.4; extra == "all"
-Requires-Dist: urllib3>=2.2.1; extra == "all"
-Requires-Dist: pydantic>=2.0; extra == "all"
-Requires-Dist: python-dotenv>=1.0.0; extra == "all"
-Requires-Dist: psutil; extra == "all"
-Dynamic: home-page
 Dynamic: license-file
-Dynamic: provides-extra
-Dynamic: requires-dist
 
 <div align="center">
 
@@ -120,6 +105,7 @@ Dynamic: requires-dist
 [![ripgrep-all](https://img.shields.io/badge/ripgrep--all-Search-E67E22?style=flat-square&logo=rust&logoColor=white)](https://github.com/phiresky/ripgrep-all)
 [![OpenAI](https://img.shields.io/badge/OpenAI-API-412991?style=flat-square&logo=openai&logoColor=white)](https://github.com/openai/openai-python)
 [![Kreuzberg](https://img.shields.io/badge/Kreuzberg-Text_Extraction-4CAF50?style=flat-square)](https://github.com/kreuzberg-dev/kreuzberg)
+[![MCP](https://img.shields.io/badge/MCP-Python_SDK-8B5CF6?style=flat-square&logo=python&logoColor=white)](https://github.com/modelcontextprotocol/python-sdk)
 
 
 [**Quick Start**](#-quick-start) · [**Key Features**](#-key-features) · [**Web UI**](#-web-ui) · [**How it Works**](#-how-it-works) · [**FAQ**](#-faq)
@@ -243,6 +229,19 @@ It serves as a unified intelligent hub for AI agents, delivering deep insights a
 ---
 
 
+## 🎉 News
+
+* 🚀 **Feb 5, 2026**: Release **v0.0.2** — MCP Support, CLI Commands & Knowledge Persistence!
+  - **MCP Integration**: Full [Model Context Protocol](https://modelcontextprotocol.io) support, works seamlessly with Claude Desktop and Cursor IDE.
+  - **CLI Commands**: New `sirchmunk` CLI with `init`, `config`, `serve`, and `search` commands.
+  - **KnowledgeCluster Persistence**: DuckDB-powered storage with Parquet export for efficient knowledge management.
+  - **Knowledge Reuse**: Semantic similarity-based cluster retrieval for faster searches via embedding vectors.
+
+* 🎉🎉 Jan 22, 2026: Introducing **Sirchmunk**: Initial Release v0.0.1 Now Available!
+
+
+---
+
 ## 🚀 Quick Start
 
 ### Prerequisites
@@ -283,9 +282,9 @@ llm = OpenAIChat(
 
 async def main():
     
-    agent_search = AgenticSearch(llm=llm)
+    searcher = AgenticSearch(llm=llm)
     
-    result: str = await agent_search.search(
+    result: str = await searcher.search(
         query="How does transformer attention work?",
         search_paths=["/path/to/documents"],
     )
@@ -296,11 +295,117 @@ asyncio.run(main())
 ```
 
 **⚠️ Notes:**
-- Upon initialization, AgenticSearch automatically checks if ripgrep-all and ripgrep are installed. If they are missing, it will attempt to install them automatically. If the automatic installation fails, please install them manually.
+- Upon initialization, `AgenticSearch` automatically checks if `ripgrep-all` and `ripgrep` are installed. If they are missing, it will attempt to install them automatically. If the automatic installation fails, please install them manually.
   - References: https://github.com/BurntSushi/ripgrep | https://github.com/phiresky/ripgrep-all
 - Replace `"your-api-key"`, `"your-base-url"`, `"your-model-name"` and `/path/to/documents` with your actual values.
 
 
+### Command Line Interface
+
+Sirchmunk provides a powerful CLI for server management and search operations.
+
+#### Installation
+
+```bash
+pip install "sirchmunk[web]"
+
+# or install via UV
+uv pip install "sirchmunk[web]"
+```
+
+
+#### Initialize
+
+```bash
+# Initialize Sirchmunk with default settings (Default work path: `~/.sirchmunk/`)
+sirchmunk init
+
+# Alternatively, initialize with custom work path
+sirchmunk init --work-path /path/to/workspace
+```
+
+#### Configure
+
+```bash
+# Show current configuration
+sirchmunk config
+
+# Regenerate configuration file if needed (Default config file: ~/.sirchmunk/.env)
+sirchmunk config --generate
+```
+
+#### Start API Server
+
+```bash
+# Start server with default settings
+sirchmunk serve
+
+# Custom host and port
+sirchmunk serve --host 0.0.0.0 --port 8000
+
+# Development mode with auto-reload
+sirchmunk serve --reload
+```
+
+#### Search
+
+```bash
+# Search in current directory
+sirchmunk search "How does authentication work?"
+
+# Search in specific paths
+sirchmunk search "find all API endpoints" ./src ./docs
+
+# Quick filename search
+sirchmunk search "config" --mode FILENAME_ONLY
+
+# Output as JSON
+sirchmunk search "database schema" --output json
+
+# Use API server (requires running server)
+sirchmunk search "query" --api --api-url http://localhost:8584
+```
+
+#### Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `sirchmunk init` | Initialize working directory and configuration |
+| `sirchmunk config` | Show or generate configuration |
+| `sirchmunk serve` | Start the API server |
+| `sirchmunk search` | Perform search queries |
+| `sirchmunk version` | Show version information |
+
+---
+
+## 🔌 MCP Server
+
+Sirchmunk provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that exposes its intelligent search capabilities as MCP tools. This enables seamless integration with AI assistants like **Claude Desktop** and **Cursor IDE**.
+
+### Quick Start
+
+```bash
+# Install MCP package
+pip install sirchmunk-mcp
+
+# Initialize and configure
+sirchmunk-mcp init
+sirchmunk-mcp config --generate
+
+# Edit ~/.sirchmunk/.mcp_env with your LLM API key
+
+# Test with MCP Inspector
+npx @modelcontextprotocol/inspector sirchmunk-mcp serve
+```
+
+### Features
+
+- **Multi-Mode Search**: DEEP mode for comprehensive analysis, FILENAME_ONLY for fast file discovery
+- **Knowledge Cluster Management**: Automatic extraction, storage, and reuse of knowledge
+- **Standard MCP Protocol**: Works with stdio and Streamable HTTP transports
+
+📖 **For detailed documentation, see [Sirchmunk MCP README](src/sirchmunk_mcp/README.md)**.
+
 ---
 
 ## 🖥️ Web UI
@@ -374,10 +479,10 @@ python scripts/stop_web.py
 
 ### Data Storage
 
-All persistent data is stored in the configured `WORK_PATH` (default: `~/.sirchmunk/`):
+All persistent data is stored in the configured `SIRCHMUNK_WORK_PATH` (default: `~/.sirchmunk/`):
 
 ```
-{WORK_PATH}/
+{SIRCHMUNK_WORK_PATH}/
   ├── .cache/
     ├── history/              # Chat session history (DuckDB)
     │   └── chat_history.db
@@ -420,7 +525,7 @@ Any OpenAI-compatible API endpoint, including (but not limited too):
 Simply specify the path in your search query:
 
 ```python
-result = await search.search(
+result = await searcher.search(
     query="Your question",
     search_paths=["/path/to/folder", "/path/to/file.pdf"]
 )
@@ -435,7 +540,7 @@ No pre-processing or indexing required!
 
 Knowledge clusters are persisted in Parquet format at:
 ```
-{WORK_PATH}/.cache/knowledge/knowledge_clusters.parquet
+{SIRCHMUNK_WORK_PATH}/.cache/knowledge/knowledge_clusters.parquet
 ```
 
 You can query them using DuckDB or the `KnowledgeManager` API.
@@ -447,7 +552,7 @@ You can query them using DuckDB or the `KnowledgeManager` API.
 
 1. **Web Dashboard**: Visit the Monitor page for real-time statistics
 2. **API**: `GET /api/v1/monitor/llm` returns usage metrics
-3. **Code**: Access `search.llm_usages` after search completion
+3. **Code**: Access `searcher.llm_usages` after search completion
 
 </details>
 

{sirchmunk-0.0.1 → sirchmunk-0.0.2}/README.md

@@ -13,6 +13,7 @@
 [![ripgrep-all](https://img.shields.io/badge/ripgrep--all-Search-E67E22?style=flat-square&logo=rust&logoColor=white)](https://github.com/phiresky/ripgrep-all)
 [![OpenAI](https://img.shields.io/badge/OpenAI-API-412991?style=flat-square&logo=openai&logoColor=white)](https://github.com/openai/openai-python)
 [![Kreuzberg](https://img.shields.io/badge/Kreuzberg-Text_Extraction-4CAF50?style=flat-square)](https://github.com/kreuzberg-dev/kreuzberg)
+[![MCP](https://img.shields.io/badge/MCP-Python_SDK-8B5CF6?style=flat-square&logo=python&logoColor=white)](https://github.com/modelcontextprotocol/python-sdk)
 
 
 [**Quick Start**](#-quick-start) · [**Key Features**](#-key-features) · [**Web UI**](#-web-ui) · [**How it Works**](#-how-it-works) · [**FAQ**](#-faq)
@@ -136,6 +137,19 @@ It serves as a unified intelligent hub for AI agents, delivering deep insights a
 ---
 
 
+## 🎉 News
+
+* 🚀 **Feb 5, 2026**: Release **v0.0.2** — MCP Support, CLI Commands & Knowledge Persistence!
+  - **MCP Integration**: Full [Model Context Protocol](https://modelcontextprotocol.io) support, works seamlessly with Claude Desktop and Cursor IDE.
+  - **CLI Commands**: New `sirchmunk` CLI with `init`, `config`, `serve`, and `search` commands.
+  - **KnowledgeCluster Persistence**: DuckDB-powered storage with Parquet export for efficient knowledge management.
+  - **Knowledge Reuse**: Semantic similarity-based cluster retrieval for faster searches via embedding vectors.
+
+* 🎉🎉 Jan 22, 2026: Introducing **Sirchmunk**: Initial Release v0.0.1 Now Available!
+
+
+---
+
 ## 🚀 Quick Start
 
 ### Prerequisites
@@ -176,9 +190,9 @@ llm = OpenAIChat(
 
 async def main():
     
-    agent_search = AgenticSearch(llm=llm)
+    searcher = AgenticSearch(llm=llm)
     
-    result: str = await agent_search.search(
+    result: str = await searcher.search(
         query="How does transformer attention work?",
         search_paths=["/path/to/documents"],
     )
@@ -189,11 +203,117 @@ asyncio.run(main())
 ```
 
 **⚠️ Notes:**
-- Upon initialization, AgenticSearch automatically checks if ripgrep-all and ripgrep are installed. If they are missing, it will attempt to install them automatically. If the automatic installation fails, please install them manually.
+- Upon initialization, `AgenticSearch` automatically checks if `ripgrep-all` and `ripgrep` are installed. If they are missing, it will attempt to install them automatically. If the automatic installation fails, please install them manually.
   - References: https://github.com/BurntSushi/ripgrep | https://github.com/phiresky/ripgrep-all
 - Replace `"your-api-key"`, `"your-base-url"`, `"your-model-name"` and `/path/to/documents` with your actual values.
 
 
+### Command Line Interface
+
+Sirchmunk provides a powerful CLI for server management and search operations.
+
+#### Installation
+
+```bash
+pip install "sirchmunk[web]"
+
+# or install via UV
+uv pip install "sirchmunk[web]"
+```
+
+
+#### Initialize
+
+```bash
+# Initialize Sirchmunk with default settings (Default work path: `~/.sirchmunk/`)
+sirchmunk init
+
+# Alternatively, initialize with custom work path
+sirchmunk init --work-path /path/to/workspace
+```
+
+#### Configure
+
+```bash
+# Show current configuration
+sirchmunk config
+
+# Regenerate configuration file if needed (Default config file: ~/.sirchmunk/.env)
+sirchmunk config --generate
+```
+
+#### Start API Server
+
+```bash
+# Start server with default settings
+sirchmunk serve
+
+# Custom host and port
+sirchmunk serve --host 0.0.0.0 --port 8000
+
+# Development mode with auto-reload
+sirchmunk serve --reload
+```
+
+#### Search
+
+```bash
+# Search in current directory
+sirchmunk search "How does authentication work?"
+
+# Search in specific paths
+sirchmunk search "find all API endpoints" ./src ./docs
+
+# Quick filename search
+sirchmunk search "config" --mode FILENAME_ONLY
+
+# Output as JSON
+sirchmunk search "database schema" --output json
+
+# Use API server (requires running server)
+sirchmunk search "query" --api --api-url http://localhost:8584
+```
+
+#### Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `sirchmunk init` | Initialize working directory and configuration |
+| `sirchmunk config` | Show or generate configuration |
+| `sirchmunk serve` | Start the API server |
+| `sirchmunk search` | Perform search queries |
+| `sirchmunk version` | Show version information |
+
+---
+
+## 🔌 MCP Server
+
+Sirchmunk provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that exposes its intelligent search capabilities as MCP tools. This enables seamless integration with AI assistants like **Claude Desktop** and **Cursor IDE**.
+
+### Quick Start
+
+```bash
+# Install MCP package
+pip install sirchmunk-mcp
+
+# Initialize and configure
+sirchmunk-mcp init
+sirchmunk-mcp config --generate
+
+# Edit ~/.sirchmunk/.mcp_env with your LLM API key
+
+# Test with MCP Inspector
+npx @modelcontextprotocol/inspector sirchmunk-mcp serve
+```
+
+### Features
+
+- **Multi-Mode Search**: DEEP mode for comprehensive analysis, FILENAME_ONLY for fast file discovery
+- **Knowledge Cluster Management**: Automatic extraction, storage, and reuse of knowledge
+- **Standard MCP Protocol**: Works with stdio and Streamable HTTP transports
+
+📖 **For detailed documentation, see [Sirchmunk MCP README](src/sirchmunk_mcp/README.md)**.
+
 ---
 
 ## 🖥️ Web UI
@@ -267,10 +387,10 @@ python scripts/stop_web.py
 
 ### Data Storage
 
-All persistent data is stored in the configured `WORK_PATH` (default: `~/.sirchmunk/`):
+All persistent data is stored in the configured `SIRCHMUNK_WORK_PATH` (default: `~/.sirchmunk/`):
 
 ```
-{WORK_PATH}/
+{SIRCHMUNK_WORK_PATH}/
   ├── .cache/
     ├── history/              # Chat session history (DuckDB)
     │   └── chat_history.db
@@ -313,7 +433,7 @@ Any OpenAI-compatible API endpoint, including (but not limited too):
 Simply specify the path in your search query:
 
 ```python
-result = await search.search(
+result = await searcher.search(
     query="Your question",
     search_paths=["/path/to/folder", "/path/to/file.pdf"]
 )
@@ -328,7 +448,7 @@ No pre-processing or indexing required!
 
 Knowledge clusters are persisted in Parquet format at:
 ```
-{WORK_PATH}/.cache/knowledge/knowledge_clusters.parquet
+{SIRCHMUNK_WORK_PATH}/.cache/knowledge/knowledge_clusters.parquet
 ```
 
 You can query them using DuckDB or the `KnowledgeManager` API.
@@ -340,7 +460,7 @@ You can query them using DuckDB or the `KnowledgeManager` API.
 
 1. **Web Dashboard**: Visit the Monitor page for real-time statistics
 2. **API**: `GET /api/v1/monitor/llm` returns usage metrics
-3. **Code**: Access `search.llm_usages` after search completion
+3. **Code**: Access `searcher.llm_usages` after search completion
 
 </details>
 

{sirchmunk-0.0.1 → sirchmunk-0.0.2}/pyproject.toml

@@ -8,7 +8,7 @@ authors = [
   {name = "ModelScope Team"},
   {email = "contact@modelscope.cn"}
 ]
-keywords = ["LLM", "Agentic", "Search", "RAG", "Indexless", "Self-evolving", "Real-time Intelligence", "Multi-modal"]
+keywords = ["LLM", "Agentic Search", "Embedding-Free", "RAG", "Indexless", "Self-evolving", "Real-time Intelligence", "Multi-modal"]
 requires-python = ">=3.10"
 classifiers = [
   "Development Status :: 4 - Beta",
@@ -35,35 +35,20 @@ build-backend = "setuptools.build_meta"
 [tool.setuptools]
 include-package-data = true
 
-[tool.setuptools.dynamic]
-version = {attr = "sirchmunk.version.__version__"}
-
 [tool.setuptools.packages.find]
 where = ["src"]
 include = ["sirchmunk*"]
 
-[tool.black]
-line-length = 88
-target-version = ["py313"]
-include = "\\.pyi?$"
-exclude = '''
-/(
-    \.eggs
-  | \.git
-  | \.hg
-  | \.mypy_cache
-  | \.tox
-  | \.venv
-  | _build
-  | buck-out
-  | build
-  | dist
-  | src/sirchmunk/.*/__pycache__
-)/
-'''
-
-[tool.ruff]
-select = ["E", "W", "F", "I"]
-ignore = ["E501"]
-target-version = "py313"
-line-length = 88
+[tool.setuptools.dynamic]
+version = {attr = "sirchmunk.version.__version__"}
+dependencies = {file = ["requirements/core.txt"]}
+
+[tool.setuptools.dynamic.optional-dependencies]
+web = {file = ["requirements/web.txt"]}
+docs     = {file = ["requirements/docs.txt"]}
+tests         = {file = ["requirements/tests.txt"]}
+all = {file = [
+  "requirements/web.txt",
+  "requirements/docs.txt",
+  "requirements/tests.txt",
+]}

sirchmunk-0.0.2/requirements/core.txt

@@ -0,0 +1,17 @@
+loguru
+fastapi
+openai
+genson
+pillow
+pypdf
+pandas
+parquet
+numpy
+msgpack
+sentencepiece
+tqdm
+rapidfuzz
+duckdb
+kreuzberg>=4.0.0rc1
+sentence-transformers
+modelscope

sirchmunk-0.0.2/requirements/docs.txt

@@ -0,0 +1,10 @@
+docutils>=0.16.0
+myst_parser
+recommonmark
+sphinx>=5.3.0
+sphinx-book-theme
+sphinx-copybutton
+sphinx-design
+sphinx_markdown_tables
+sphinxawesome-theme
+sphinxcontrib-mermaid

sirchmunk-0.0.2/requirements/tests.txt

@@ -0,0 +1,2 @@
+pytest
+pytest-asyncio

sirchmunk-0.0.2/requirements/web.txt

@@ -0,0 +1,19 @@
+# --- Web Framework & Server ---
+fastapi>=0.100.0
+uvicorn[standard]>=0.24.0
+websockets>=12.0
+python-multipart>=0.0.6
+pydantic>=2.0.0
+
+# --- HTTP Clients ---
+requests>=2.32.2
+aiohttp>=3.9.4
+httpx>=0.27.0
+urllib3>=2.2.1
+
+# --- Data Validation & Environment ---
+pydantic>=2.0
+python-dotenv>=1.0.0
+
+# --- System & Utilities ---
+psutil