Metadata-Version: 2.4
Name: chunkhound
Version: 3.0.0
Summary: Local-first semantic code search with vector and regex capabilities for AI assistants via MCP
Project-URL: Homepage, https://github.com/chunkhound/chunkhound
Project-URL: Repository, https://github.com/chunkhound/chunkhound
Project-URL: Issues, https://github.com/chunkhound/chunkhound/issues
Project-URL: Documentation, https://github.com/chunkhound/chunkhound#readme
Project-URL: Changelog, https://github.com/chunkhound/chunkhound/releases
Author: Ofri Wolfus
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Indexing
Requires-Python: >=3.10
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: click>=8.0.0
Requires-Dist: duckdb>=0.8.0
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: lancedb>=0.24.0
Requires-Dist: loguru>=0.6.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: openai>=1.0.0
Requires-Dist: pandas>=2.3.0
Requires-Dist: psutil>=5.8.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pylance>=0.31.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: tiktoken>=0.9.0
Requires-Dist: tqdm>=4.66.0
Requires-Dist: tree-sitter-bash<0.25.0,>=0.21.0
Requires-Dist: tree-sitter-c<0.23.0,>=0.21.0
Requires-Dist: tree-sitter-cpp<0.24.0,>=0.21.0
Requires-Dist: tree-sitter-go>=0.21.0
Requires-Dist: tree-sitter-groovy>=0.1.2
Requires-Dist: tree-sitter-java>=0.21.0
Requires-Dist: tree-sitter-javascript>=0.21.0
Requires-Dist: tree-sitter-json>=0.21.0
Requires-Dist: tree-sitter-kotlin>=0.3.0
Requires-Dist: tree-sitter-language-pack>=0.7.3
Requires-Dist: tree-sitter-make>=0.1.0
Requires-Dist: tree-sitter-markdown
Requires-Dist: tree-sitter-python>=0.20.0
Requires-Dist: tree-sitter-rust<0.23.0,>=0.21.0
Requires-Dist: tree-sitter-toml>=0.5.0
Requires-Dist: tree-sitter-typescript>=0.21.0
Requires-Dist: tree-sitter<0.24.0,>=0.20.0
Requires-Dist: voyageai>=0.2.0
Requires-Dist: watchdog>=4.0.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: mypy>=1.6.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

<p align="center">
  <a href="https://ofriw.github.io/chunkhound">
    <img src="docs/public/wordmark.svg" alt="ChunkHound" width="400">
  </a>
</p>

<p align="center">
  <strong>Modern RAG for your codebase - semantic and regex search via MCP.</strong>
</p>

<p align="center">
  <a href="https://github.com/ofriw/chunkhound/actions">
    <img src="https://github.com/ofriw/chunkhound/actions/workflows/tests.yml/badge.svg" alt="Tests">
  </a>
</p>

Transform your codebase into a searchable knowledge base for AI assistants using semantic and regex search.

## ✨ Features

- **Semantic search** - Natural language queries like "find authentication code"
- **Regex search** - Pattern matching without API keys
- **20+ languages** - Python, TypeScript, Java, C++, Go, Rust, and more
- **MCP integration** - Works with Claude, VS Code, Cursor, Windsurf, Zed
- **Local-first** - Your code stays on your machine
- **Smart indexing** - Only processes changed files

## 📚 Documentation

**Visit [ofriw.github.io/chunkhound](https://ofriw.github.io/chunkhound) for complete guides:**
- [🚀 5-Minute Tutorial](https://ofriw.github.io/chunkhound/tutorial/)
- [🔧 Configuration Guide](https://ofriw.github.io/chunkhound/configuration/)
- [🏗️ Architecture Deep Dive](https://ofriw.github.io/chunkhound/under-the-hood/)

## Installation

```bash
# Install uv if needed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install ChunkHound
uv tool install chunkhound
```

## Quick Start

```bash
# Index your codebase
chunkhound index

# Start MCP server for AI assistants
chunkhound mcp
```

**For configuration, IDE setup, and advanced usage, see the [documentation](https://ofriw.github.io/chunkhound).**

## IDE Setup

ChunkHound works with Claude Desktop, Claude Code, VS Code, Cursor, Windsurf, Zed, and IntelliJ IDEA.

**See the [configuration guide](https://ofriw.github.io/chunkhound/configuration/) for setup instructions.**

## Requirements

- Python 3.10+
- [uv package manager](https://docs.astral.sh/uv/)
- API key for semantic search (optional - regex search works without any keys)

## Origin Story

**100% of ChunkHound's code was written by an AI agent** - zero lines written by hand. The entire codebase emerged through iterative human-AI collaboration where the AI agent used ChunkHound to search its own code, creating a self-improving feedback loop.

## License

MIT
