Pre-release

This release is a pre-release and may not be stable for production use.

ChunkHound

Local-first codebase intelligence

Tests License: MIT 100% AI Generated Discord

Your AI assistant searches code but doesn't understand it. ChunkHound researches your codebase—extracting architecture, patterns, and institutional knowledge at any scale. Integrates via MCP.

Features

  • cAST Algorithm - Research-backed semantic code chunking
  • Multi-Hop Semantic Search - Discovers interconnected code relationships beyond direct matches
  • Semantic search - Natural language queries like "find authentication code"
  • Regex search - Pattern matching without API keys
  • Local-first - Your code stays on your machine
  • 32 languages with structured parsing
    • Programming (via Tree-sitter): Python, JavaScript, TypeScript, JSX, TSX, Java, Kotlin, Groovy, C, C++, C#, Go, Rust, Haskell, Swift, Bash, MATLAB, Makefile, Objective-C, PHP, Dart, Lua, Vue, Svelte, Zig
    • Configuration: JSON, YAML, TOML, HCL, Markdown
    • Text-based (custom parsers): Text files, PDF
  • MCP integration - Works with Claude, VS Code, Cursor, Windsurf, Zed, etc
  • Real-time indexing - Automatic file watching, smart diffs, seamless branch switching, and explicit backend selection (watchdog, watchman, polling)

Documentation

Visit chunkhound.ai for documentation:

Requirements

Installation

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

# Install ChunkHound
uv tool install chunkhound

Quick Start

  1. Create .chunkhound.json in project root
{
  "embedding": {
    "provider": "voyageai",
    "api_key": "your-voyageai-key"
  },
  "llm": {
    "provider": "claude-code-cli"
  }
}

Note: Use "codex-cli" instead if you prefer Codex. Both work equally well and require no API key.

  1. Index your codebase
chunkhound index
  1. Search changed code in recent commits
# Last N commits
chunkhound search "authentication changes" --last-n 20

# Changes introduced by that commit (diff against its parent; root commits use empty tree)
chunkhound search "database migration" --commit-hash abc1234

# Custom git range
chunkhound search "API changes" --commit-range v2.0..HEAD

# Deep research over recent changes
chunkhound research "what changed in the auth module?" --last-n 50

--vector-source controls scope: diff (default, changed code only), both (merges diff + DB), db (ignore diff).

For configuration, IDE setup, and advanced usage, see the documentation.

Why ChunkHound?

Approach Capability Scale Maintenance
Keyword Search Exact matching Fast None
Traditional RAG Semantic search Scales Re-index files
Knowledge Graphs Relationship queries Expensive Continuous sync
ChunkHound Semantic + Regex + Code Research Automatic Incremental + realtime

Ideal for:

  • Large monorepos with cross-team dependencies
  • Security-sensitive codebases (local-only, no cloud)
  • Multi-language projects needing consistent search
  • Offline/air-gapped development environments

License

MIT

Project links

Data verified by PyPI on Jul 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (5.2.1)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for Hanan_kavitz from gravatar.com Hanan_kavitz Avatar for ofriw from gravatar.com ofriw

Credits

Author: Ofri Wolfus

GitHub Statistics

Data verified by PyPI on Jul 12, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License

Requires

Python <3.15, >=3.10

Provides Extra

dev native test

Tags

AI agents CAST algorithm MCP code search semantic search vector search

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chunkhound-5.2.0a4.tar.gz (1.3 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

chunkhound-5.2.0a4-py3-none-win_amd64.whl (12.6 MB view details)

Uploaded Python 3Windows x86-64

chunkhound-5.2.0a4-py3-none-manylinux_2_34_x86_64.whl (6.7 MB view details)

Uploaded Python 3manylinux: glibc 2.34+ x86-64

File details

Details for the file chunkhound-5.2.0a4.tar.gz.

File metadata

  • Download URL: chunkhound-5.2.0a4.tar.gz
  • Upload date:
  • Size: 1.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for chunkhound-5.2.0a4.tar.gz
Algorithm Hash digest
SHA256 4820f3c6edb786ace28a0a2a854bd420a1b84482b2977b2b0dfdf002a34428ad
MD5 77d9f188d34da130825df5c4427d5270
BLAKE2b-256 59476892eab11e6c4f5f86a85a989b69a069c29b67e74d980f74a91acff04dc4

See more details on using hashes here.

Provenance

The following attestation bundles were made for chunkhound-5.2.0a4.tar.gz:

Publisher: release-rc.yml on chunkhound/chunkhound

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chunkhound-5.2.0a4-py3-none-win_amd64.whl.

File metadata

  • Download URL: chunkhound-5.2.0a4-py3-none-win_amd64.whl
  • Upload date:
  • Size: 12.6 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for chunkhound-5.2.0a4-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 45597c53b7201c94d4fa7f138e885c222e67f424396c4137359fcdccd76a088c
MD5 d050f587c90c68a82996705dccfbdca6
BLAKE2b-256 a862920c4e73a6752e6fb9f03d378c605bd40bd4088f58e5904cbbf29413dbb4

See more details on using hashes here.

Provenance

The following attestation bundles were made for chunkhound-5.2.0a4-py3-none-win_amd64.whl:

Publisher: release-rc.yml on chunkhound/chunkhound

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chunkhound-5.2.0a4-py3-none-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for chunkhound-5.2.0a4-py3-none-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 89848d66352c2efafcefb8625e5a4d9406b656434e05c02617b4777ed834b656
MD5 698341c5879e358d204939c1b21e85c2
BLAKE2b-256 ea85f40424af849f3512767c2e871877e642bc8b338b4e73c5dad2006c37c8d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for chunkhound-5.2.0a4-py3-none-manylinux_2_34_x86_64.whl:

Publisher: release-rc.yml on chunkhound/chunkhound

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

5.2.1

3 files

5.2.0

3 files

Pre-release

5.2.0a6

3 files

This release
Pre-release

5.2.0a4 This release

3 files

5.1.0

3 files

Pre-release

5.1.0a1

3 files

5.0.0

3 files

Pre-release

5.0.0a1

3 files

Pre-release

4.1.0b1

2 files

Pre-release

4.1.0a1

2 files

4.0.1

2 files

4.0.0

2 files

3.3.1

2 files

3.3.0

2 files

3.2.0

2 files

3.1.0

2 files

3.0.1

2 files

3.0.0

2 files

2.8.1

2 files

2.8.0

2 files

2.7.0

2 files

2.6.3

2 files

2.6.2

2 files

2.6.1

2 files

2.6.0

2 files

2.5.4

2 files

2.5.3

2 files

2.5.2

2 files

2.5.1

2 files

2.5.0

2 files

2.4.4

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.1

2 files

2.3.0

2 files

2.2.0

2 files

2.1.4

2 files

2.1.3

2 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.0

2 files

1.2.3

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.0.1

2 files

1.0.0

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page