neuralmind 0.1.0__tar.gz

neuralmind-0.1.0/.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv/
+
+# ChromaDB databases
+**/neuralmind_db/
+*.sqlite3
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# OS
+.DS_Store
+Thumbs.db

neuralmind-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 NeuralMind Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

neuralmind-0.1.0/PKG-INFO

@@ -0,0 +1,356 @@
+Metadata-Version: 2.4
+Name: neuralmind
+Version: 0.1.0
+Summary: Adaptive Neural Knowledge System - Achieve 40-70x token reduction for AI code understanding
+Project-URL: Homepage, https://github.com/dfrostar/neuralmind
+Project-URL: Documentation, https://github.com/dfrostar/neuralmind/wiki
+Project-URL: Repository, https://github.com/dfrostar/neuralmind.git
+Project-URL: Issues, https://github.com/dfrostar/neuralmind/issues
+Project-URL: Changelog, https://github.com/dfrostar/neuralmind/releases
+Author: dfrostar
+Maintainer: dfrostar
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,ai-coding-assistant,chromadb,code-understanding,context-window,embeddings,knowledge-graph,llm,mcp,semantic-search,token-reduction
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: chromadb>=0.4.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: all
+Requires-Dist: black>=23.0; extra == 'all'
+Requires-Dist: mcp>=0.1.0; extra == 'all'
+Requires-Dist: mypy>=1.0; extra == 'all'
+Requires-Dist: pre-commit>=3.0; extra == 'all'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'all'
+Requires-Dist: pytest-cov>=4.0; extra == 'all'
+Requires-Dist: pytest-mock>=3.10; extra == 'all'
+Requires-Dist: pytest>=7.0; extra == 'all'
+Requires-Dist: ruff>=0.1.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: black>=23.0; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.10; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=0.1.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# 🧠 NeuralMind
+
+### **Stop Wasting Tokens. Start Understanding Code.**
+
+[![CI](https://github.com/dfrostar/neuralmind/actions/workflows/ci.yml/badge.svg)](https://github.com/dfrostar/neuralmind/actions/workflows/ci.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**NeuralMind gives AI assistants 40-70x more efficient access to your codebase.**
+
+[Why NeuralMind?](#-why-neuralmind) •
+[Install in 2 Minutes](#-installation) •
+[Quick Start](#-quick-start) •
+[How It Works](#-how-it-works) •
+[Wiki](https://github.com/dfrostar/neuralmind/wiki)
+
+</div>
+
+---
+
+## 🎯 Why NeuralMind?
+
+### The Problem
+
+When you ask Claude, GPT-4, or Cursor about your codebase:
+
+| Traditional Approach | Tokens Used | Result |
+|---------------------|-------------|--------|
+| Load entire codebase | **50,000+** | ❌ Hits context limits, expensive, slow |
+| Load a few files manually | **5,000** | ❌ Misses important context |
+| Hope the AI figures it out | **0** | ❌ Wrong answers, hallucinations |
+
+### The Solution
+
+**NeuralMind loads only what's relevant to your question:**
+
+| NeuralMind Approach | Tokens Used | Result |
+|--------------------|-------------|--------|
+| Wake-up context | **~400** | ✅ AI understands project structure |
+| Query context | **~800-1,100** | ✅ AI gets relevant code clusters |
+| **Total** | **~1,500** | ✅ **40-70x fewer tokens!** |
+
+### Real Benchmarks
+
+| Project | Codebase Size | NeuralMind Tokens | Reduction |
+|---------|---------------|-------------------|----------|
+| cmmc20 (full-stack app) | 241 code entities | 765 avg | **65.6x** |
+| mempalace (Python lib) | 1,626 code entities | 1,089 avg | **46.0x** |
+
+---
+
+## 📦 Installation
+
+### Step 1: Install NeuralMind
+
+```bash
+# From GitHub (available now)
+pip install git+https://github.com/dfrostar/neuralmind.git
+
+# From PyPI (coming soon)
+pip install neuralmind
+```
+
+### Step 2: Install Graphify (creates the knowledge graph)
+
+```bash
+pip install graphifyy
+```
+
+### Step 3: Verify Installation
+
+```bash
+neuralmind --help
+graphify --help
+```
+
+**That's it!** You're ready to use NeuralMind.
+
+---
+
+## 🚀 Quick Start
+
+### 1. Generate Knowledge Graph (one-time per project)
+
+```bash
+cd /path/to/your/project
+graphify update .
+```
+
+This creates `graphify-out/graph.json` with your codebase structure.
+
+### 2. Build Neural Index
+
+```bash
+neuralmind build .
+```
+
+**Output:**
+```
+Building NeuralMind index for: .
+Build successful!
+   Project: my-project
+   Nodes: 241
+   Communities: 93
+   Duration: 16.65s
+```
+
+### 3. Query Your Codebase
+
+```bash
+# Get compact context for any question
+neuralmind query . "How does authentication work?"
+```
+
+**Output:**
+```
+Query: How does authentication work?
+Tokens: 739 (67.7x reduction)
+============================================================
+## Project: my-project
+Knowledge Graph: 241 entities, 93 clusters
+
+## Relevant Code Areas
+### Cluster 1 (relevance: 2.45)
+Contains: 5 codes
+- AuthService (code) — authService.ts
+- hashPassword() (code) — authService.ts
+- verifyToken() (code) — authService.ts
+...
+============================================================
+```
+
+### 4. Use with AI Assistants
+
+Copy the output and paste it into your AI conversation for instant, relevant context!
+
+---
+
+## 📖 All Commands
+
+| Command | What It Does | Example |
+|---------|--------------|--------|
+| `build` | Create neural index from graph.json | `neuralmind build .` |
+| `query` | Get context for a question | `neuralmind query . "How does X work?"` |
+| `wakeup` | Get minimal startup context | `neuralmind wakeup .` |
+| `search` | Semantic search for code | `neuralmind search . "authentication"` |
+| `benchmark` | Measure token reduction | `neuralmind benchmark .` |
+| `stats` | Show index statistics | `neuralmind stats .` |
+
+### JSON Output (for automation)
+
+```bash
+neuralmind query . "How does auth work?" --json
+```
+
+---
+
+## 🔧 How It Works
+
+### 4-Layer Progressive Disclosure
+
+NeuralMind uses a smart layering system to minimize tokens:
+
+```
+┌─────────────────────────────────────────────────────┐
+│  L0: Identity (~100 tokens)                         │
+│  "Project name, description, graph stats"           │
+│  └── Always loaded                                  │
+├─────────────────────────────────────────────────────┤
+│  L1: Summary (~300 tokens)                          │
+│  "Architecture overview, main code clusters"        │
+│  └── Always loaded                                  │
+├─────────────────────────────────────────────────────┤
+│  L2: On-Demand (~200-400 tokens)                    │
+│  "Relevant modules based on your query"             │
+│  └── Loaded per query                               │
+├─────────────────────────────────────────────────────┤
+│  L3: Search Results (~200-400 tokens)               │
+│  "Semantic search matches"                          │
+│  └── Loaded per query                               │
+└─────────────────────────────────────────────────────┘
+
+Total: ~800-1,100 tokens vs 50,000+ for full codebase
+```
+
+### Data Flow
+
+```
+Your Code → Graphify → graph.json → NeuralMind → ChromaDB
+                                         ↓
+                              Smart Context for AI
+```
+
+---
+
+## 🔌 MCP Integration (Claude Desktop, Cursor)
+
+NeuralMind includes an MCP server for direct integration:
+
+```bash
+# Install with MCP support
+pip install "neuralmind[mcp]"
+
+# Run the server
+neuralmind-mcp
+```
+
+Add to your Claude Desktop config (`~/.config/claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "neuralmind": {
+      "command": "neuralmind-mcp"
+    }
+  }
+}
+```
+
+---
+
+## 🐍 Python API
+
+```python
+from neuralmind import NeuralMind
+
+# Initialize for your project
+mind = NeuralMind('/path/to/project')
+mind.build()
+
+# Get wake-up context (for starting conversations)
+wakeup = mind.wakeup()
+print(f"Tokens: {wakeup.budget.total}")  # ~400
+
+# Get query context (for specific questions)
+result = mind.query("How does authentication work?")
+print(f"Tokens: {result.budget.total}")  # ~800
+print(f"Reduction: {result.reduction_ratio:.1f}x")  # ~65x
+print(result.context)  # The actual context to use
+```
+
+---
+
+## 📊 Why This Matters
+
+| Benefit | Impact |
+|---------|--------|
+| **Cost Savings** | 40-70x fewer tokens = 40-70x lower API costs |
+| **Faster Responses** | Less to process = faster AI responses |
+| **Better Answers** | Relevant context = more accurate answers |
+| **Longer Conversations** | More room for back-and-forth |
+| **Works Everywhere** | CLI, Python API, MCP server |
+
+---
+
+## 📚 Documentation
+
+- **[Wiki Home](https://github.com/dfrostar/neuralmind/wiki)** — Full documentation
+- **[Installation Guide](https://github.com/dfrostar/neuralmind/wiki/Installation)** — Detailed setup
+- **[CLI Reference](https://github.com/dfrostar/neuralmind/wiki/CLI-Reference)** — All commands
+- **[API Reference](https://github.com/dfrostar/neuralmind/wiki/API-Reference)** — Python API
+- **[Architecture](https://github.com/dfrostar/neuralmind/wiki/Architecture)** — How it works
+- **[Troubleshooting](https://github.com/dfrostar/neuralmind/wiki/Troubleshooting)** — Common issues
+
+---
+
+## 🤝 Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+```bash
+# Clone and install for development
+git clone https://github.com/dfrostar/neuralmind.git
+cd neuralmind
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- **[ChromaDB](https://www.trychroma.com/)** — Vector storage
+- **[Graphify](https://github.com/safishamsi/graphify)** — Knowledge graph generation
+- **[code-review-graph](https://github.com/tirth8205/code-review-graph)** — Inspiration
+
+---
+
+<div align="center">
+
+**Made with 🧠 by [Agent Zero](https://github.com/frdel/agent-zero)**
+
+*Stop wasting tokens. Start understanding code.*
+
+</div>

neuralmind-0.1.0/README.md

@@ -0,0 +1,305 @@
+<div align="center">
+
+# 🧠 NeuralMind
+
+### **Stop Wasting Tokens. Start Understanding Code.**
+
+[![CI](https://github.com/dfrostar/neuralmind/actions/workflows/ci.yml/badge.svg)](https://github.com/dfrostar/neuralmind/actions/workflows/ci.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**NeuralMind gives AI assistants 40-70x more efficient access to your codebase.**
+
+[Why NeuralMind?](#-why-neuralmind) •
+[Install in 2 Minutes](#-installation) •
+[Quick Start](#-quick-start) •
+[How It Works](#-how-it-works) •
+[Wiki](https://github.com/dfrostar/neuralmind/wiki)
+
+</div>
+
+---
+
+## 🎯 Why NeuralMind?
+
+### The Problem
+
+When you ask Claude, GPT-4, or Cursor about your codebase:
+
+| Traditional Approach | Tokens Used | Result |
+|---------------------|-------------|--------|
+| Load entire codebase | **50,000+** | ❌ Hits context limits, expensive, slow |
+| Load a few files manually | **5,000** | ❌ Misses important context |
+| Hope the AI figures it out | **0** | ❌ Wrong answers, hallucinations |
+
+### The Solution
+
+**NeuralMind loads only what's relevant to your question:**
+
+| NeuralMind Approach | Tokens Used | Result |
+|--------------------|-------------|--------|
+| Wake-up context | **~400** | ✅ AI understands project structure |
+| Query context | **~800-1,100** | ✅ AI gets relevant code clusters |
+| **Total** | **~1,500** | ✅ **40-70x fewer tokens!** |
+
+### Real Benchmarks
+
+| Project | Codebase Size | NeuralMind Tokens | Reduction |
+|---------|---------------|-------------------|----------|
+| cmmc20 (full-stack app) | 241 code entities | 765 avg | **65.6x** |
+| mempalace (Python lib) | 1,626 code entities | 1,089 avg | **46.0x** |
+
+---
+
+## 📦 Installation
+
+### Step 1: Install NeuralMind
+
+```bash
+# From GitHub (available now)
+pip install git+https://github.com/dfrostar/neuralmind.git
+
+# From PyPI (coming soon)
+pip install neuralmind
+```
+
+### Step 2: Install Graphify (creates the knowledge graph)
+
+```bash
+pip install graphifyy
+```
+
+### Step 3: Verify Installation
+
+```bash
+neuralmind --help
+graphify --help
+```
+
+**That's it!** You're ready to use NeuralMind.
+
+---
+
+## 🚀 Quick Start
+
+### 1. Generate Knowledge Graph (one-time per project)
+
+```bash
+cd /path/to/your/project
+graphify update .
+```
+
+This creates `graphify-out/graph.json` with your codebase structure.
+
+### 2. Build Neural Index
+
+```bash
+neuralmind build .
+```
+
+**Output:**
+```
+Building NeuralMind index for: .
+Build successful!
+   Project: my-project
+   Nodes: 241
+   Communities: 93
+   Duration: 16.65s
+```
+
+### 3. Query Your Codebase
+
+```bash
+# Get compact context for any question
+neuralmind query . "How does authentication work?"
+```
+
+**Output:**
+```
+Query: How does authentication work?
+Tokens: 739 (67.7x reduction)
+============================================================
+## Project: my-project
+Knowledge Graph: 241 entities, 93 clusters
+
+## Relevant Code Areas
+### Cluster 1 (relevance: 2.45)
+Contains: 5 codes
+- AuthService (code) — authService.ts
+- hashPassword() (code) — authService.ts
+- verifyToken() (code) — authService.ts
+...
+============================================================
+```
+
+### 4. Use with AI Assistants
+
+Copy the output and paste it into your AI conversation for instant, relevant context!
+
+---
+
+## 📖 All Commands
+
+| Command | What It Does | Example |
+|---------|--------------|--------|
+| `build` | Create neural index from graph.json | `neuralmind build .` |
+| `query` | Get context for a question | `neuralmind query . "How does X work?"` |
+| `wakeup` | Get minimal startup context | `neuralmind wakeup .` |
+| `search` | Semantic search for code | `neuralmind search . "authentication"` |
+| `benchmark` | Measure token reduction | `neuralmind benchmark .` |
+| `stats` | Show index statistics | `neuralmind stats .` |
+
+### JSON Output (for automation)
+
+```bash
+neuralmind query . "How does auth work?" --json
+```
+
+---
+
+## 🔧 How It Works
+
+### 4-Layer Progressive Disclosure
+
+NeuralMind uses a smart layering system to minimize tokens:
+
+```
+┌─────────────────────────────────────────────────────┐
+│  L0: Identity (~100 tokens)                         │
+│  "Project name, description, graph stats"           │
+│  └── Always loaded                                  │
+├─────────────────────────────────────────────────────┤
+│  L1: Summary (~300 tokens)                          │
+│  "Architecture overview, main code clusters"        │
+│  └── Always loaded                                  │
+├─────────────────────────────────────────────────────┤
+│  L2: On-Demand (~200-400 tokens)                    │
+│  "Relevant modules based on your query"             │
+│  └── Loaded per query                               │
+├─────────────────────────────────────────────────────┤
+│  L3: Search Results (~200-400 tokens)               │
+│  "Semantic search matches"                          │
+│  └── Loaded per query                               │
+└─────────────────────────────────────────────────────┘
+
+Total: ~800-1,100 tokens vs 50,000+ for full codebase
+```
+
+### Data Flow
+
+```
+Your Code → Graphify → graph.json → NeuralMind → ChromaDB
+                                         ↓
+                              Smart Context for AI
+```
+
+---
+
+## 🔌 MCP Integration (Claude Desktop, Cursor)
+
+NeuralMind includes an MCP server for direct integration:
+
+```bash
+# Install with MCP support
+pip install "neuralmind[mcp]"
+
+# Run the server
+neuralmind-mcp
+```
+
+Add to your Claude Desktop config (`~/.config/claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "neuralmind": {
+      "command": "neuralmind-mcp"
+    }
+  }
+}
+```
+
+---
+
+## 🐍 Python API
+
+```python
+from neuralmind import NeuralMind
+
+# Initialize for your project
+mind = NeuralMind('/path/to/project')
+mind.build()
+
+# Get wake-up context (for starting conversations)
+wakeup = mind.wakeup()
+print(f"Tokens: {wakeup.budget.total}")  # ~400
+
+# Get query context (for specific questions)
+result = mind.query("How does authentication work?")
+print(f"Tokens: {result.budget.total}")  # ~800
+print(f"Reduction: {result.reduction_ratio:.1f}x")  # ~65x
+print(result.context)  # The actual context to use
+```
+
+---
+
+## 📊 Why This Matters
+
+| Benefit | Impact |
+|---------|--------|
+| **Cost Savings** | 40-70x fewer tokens = 40-70x lower API costs |
+| **Faster Responses** | Less to process = faster AI responses |
+| **Better Answers** | Relevant context = more accurate answers |
+| **Longer Conversations** | More room for back-and-forth |
+| **Works Everywhere** | CLI, Python API, MCP server |
+
+---
+
+## 📚 Documentation
+
+- **[Wiki Home](https://github.com/dfrostar/neuralmind/wiki)** — Full documentation
+- **[Installation Guide](https://github.com/dfrostar/neuralmind/wiki/Installation)** — Detailed setup
+- **[CLI Reference](https://github.com/dfrostar/neuralmind/wiki/CLI-Reference)** — All commands
+- **[API Reference](https://github.com/dfrostar/neuralmind/wiki/API-Reference)** — Python API
+- **[Architecture](https://github.com/dfrostar/neuralmind/wiki/Architecture)** — How it works
+- **[Troubleshooting](https://github.com/dfrostar/neuralmind/wiki/Troubleshooting)** — Common issues
+
+---
+
+## 🤝 Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+```bash
+# Clone and install for development
+git clone https://github.com/dfrostar/neuralmind.git
+cd neuralmind
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- **[ChromaDB](https://www.trychroma.com/)** — Vector storage
+- **[Graphify](https://github.com/safishamsi/graphify)** — Knowledge graph generation
+- **[code-review-graph](https://github.com/tirth8205/code-review-graph)** — Inspiration
+
+---
+
+<div align="center">
+
+**Made with 🧠 by [Agent Zero](https://github.com/frdel/agent-zero)**
+
+*Stop wasting tokens. Start understanding code.*
+
+</div>

neuralmind-0.1.0/pyproject.toml

@@ -0,0 +1,185 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "neuralmind"
+version = "0.1.0"
+description = "Adaptive Neural Knowledge System - Achieve 40-70x token reduction for AI code understanding"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "dfrostar" }
+]
+maintainers = [
+    { name = "dfrostar" }
+]
+keywords = [
+    "ai",
+    "llm",
+    "code-understanding",
+    "knowledge-graph",
+    "token-reduction",
+    "semantic-search",
+    "mcp",
+    "chromadb",
+    "embeddings",
+    "context-window",
+    "ai-coding-assistant"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Typing :: Typed"
+]
+requires-python = ">=3.10"
+dependencies = [
+    "chromadb>=0.4.0",
+    "pyyaml>=6.0"
+]
+
+[project.optional-dependencies]
+mcp = [
+    "mcp>=0.1.0"
+]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0",
+    "pytest-mock>=3.10",
+    "black>=23.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0",
+    "pre-commit>=3.0"
+]
+all = [
+    "neuralmind[mcp,dev]"
+]
+
+[project.scripts]
+neuralmind = "neuralmind.cli:main"
+neuralmind-mcp = "neuralmind.mcp_server:main"
+
+[project.urls]
+Homepage = "https://github.com/dfrostar/neuralmind"
+Documentation = "https://github.com/dfrostar/neuralmind/wiki"
+Repository = "https://github.com/dfrostar/neuralmind.git"
+Issues = "https://github.com/dfrostar/neuralmind/issues"
+Changelog = "https://github.com/dfrostar/neuralmind/releases"
+
+[tool.hatch.build.targets.wheel]
+packages = ["neuralmind"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "neuralmind/**/*.py",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+]
+
+# PyPI Trusted Publishing Configuration
+# To enable trusted publishing on PyPI:
+# 1. Go to https://pypi.org/manage/project/neuralmind/settings/publishing/
+# 2. Add a new trusted publisher with:
+#    - Owner: dfrostar
+#    - Repository: neuralmind
+#    - Workflow: release.yml
+#    - Environment: pypi
+
+[tool.black]
+line-length = 100
+target-version = ["py310", "py311", "py312"]
+include = '\.pyi?$'
+exclude = '''
+/(
+    \.git
+    | \.hg
+    | \.mypy_cache
+    | \.tox
+    | \.venv
+    | _build
+    | buck-out
+    | build
+    | dist
+)/
+'''
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "F",   # pyflakes
+    "W",   # pycodestyle warnings
+    "I",   # isort
+    "N",   # pep8-naming
+    "UP",  # pyupgrade
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "T10", # flake8-debugger
+    "ISC", # flake8-implicit-str-concat
+    "PIE", # flake8-pie
+    "RET", # flake8-return
+]
+ignore = [
+    "E501",   # line too long (handled by black)
+    "B008",   # function call in argument defaults
+    "C901",   # too complex
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["S101", "F841", "PT011", "PT012"]  # allow assert and test patterns
+
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+strict_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = ["chromadb.*", "mcp.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "-ra -q --strict-markers"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+python_classes = ["Test*"]
+markers = [
+    "slow: marks tests as slow",
+    "integration: marks tests as integration tests",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["neuralmind"]
+omit = ["*/tests/*", "*/__pycache__/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+]