chunkhound

本地跑起来，用大白话搜代码、问代码，秒懂陌生项目。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 160 🐛 待处理 114 👀 关注 7

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1460

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，本地部署，完全免费。

项目预览

项目数据

分类搜索知识

开发团队chunkhound

官网地址https://chunkhound.ai

GitHubhttps://github.com/chunkhound/chunkhound

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，本地部署，完全免费。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,ai,duckdb,mcp-server,rag,semantic-search,tree-sitter

GitHub 星标★ 1460

上线时间2025-06-04 00:00:00

代码更新2026-11-09

仓库体积17.0 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

chunkhound 是一个本地优先的代码库智能工具，旨在帮助开发者快速理解和检索大型代码库。它通过将代码库分割成语义化的块（chunk），并利用嵌入模型生成向量索引，支持自然语言搜索和问答。项目解决了传统代码搜索依赖关键词匹配、难以理解代码意图的问题，提供了从代码到知识的桥梁。核心能力包括代码块语义索引、混合检索（向量+关键词）、上下文感知的代码问答，以及本地化部署保障数据隐私。它支持多种编程语言，可与主流编辑器集成，适合个人开发者或团队在本地环境中探索陌生代码库、定位功能实现、生成代码文档等场景。项目采用 Python 编写，依赖现代 NLP 技术，处于积极开发阶段，社区活跃度较高。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1460

技术标签

agent ai duckdb mcp-server rag

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 5 分钟部署方式：命令行工具 3 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

已安装 uv（README 提供的安装方式基于 uv 工具）
可访问 PyPI 网络以下载 chunkhound 包
本地可写入索引/缓存数据的磁盘空间（项目为本地优先）

安装与启动步骤

1确认 uv 可用

README 只给出基于 uv 的安装方式，请先在终端确认 uv 命令可正常执行，若未安装需先准备好 uv 环境。
```
uv --version
```
2安装 chunkhound

使用 uv 以全局工具方式安装 chunkhound，uv 会自动下载并隔离其依赖环境。
```
uv tool install chunkhound
```
3确认安装结果

查看 uv 已安装的工具列表，确认 chunkhound 出现在其中即表示安装完成。
```
uv tool list
```