给 ChromaDB 写了个桌面调试工具,开源出来了,不用再手搓 curl 了
最近在做 RAG,ChromaDB 的检索效果调试实在太费劲了。每次想看某个集合里有什么数据、测试一下不同 Embedding 的召回效果,要么写脚本,要么 curl 怼 API,效率很低。
市面上找了一圈,Milvus 还有个 Attu,ChromaDB 基本没啥趁手的 GUI 工具。所以就自己动手写了一个——RAGPeek,分享出来给需要的朋友。
GitHub: https://github.com/yyy-router/RAGPeek
先放几张图看看长啥样:



能干什么
几个核心功能:
1. 连接 ChromaDB,浏览集合
输入地址就能连,本地远程都行。连上后左侧列出所有集合,点进去看 Schema 和文档。文档支持分页浏览、查看详情、复制 JSON、批量删除。
2. 语义搜索(Query Playground)
不需要写代码,选择集合,输入查询文本,就能搜。支持配置多个 Embedding 服务商——OpenAI、智谱、Ollama 都行,只要兼容 OpenAI 的 /v1/embeddings 格式。
API Key 用操作系统的加密机制存储,不会明文落盘。
点击右上角的设置按钮,可以配置embedding模型的api;
3. 对比检索结果(Chunk Compare)
这个功能是我最需要的——选两个集合,同一个查询,并排看各自的 Top K 结果。
比如我做 Chunk 实验,256 和 512 各存了一个集合,想知道哪种切法召回更准,以前要翻来覆去对比 JSON,现在左右一摆,一眼就能看出来。
4. 暗色模式 + 缩放
支持一键切换暗色 / 亮色主题,还支持 Ctrl+/- 缩放界面。长时间调试眼睛不会太累。
怎么用
装 ChromaDB 就不说了,直接装 RAGPeek。
去 Releases 页面下载安装包:https://github.com/yyy-router/RAGPeek/releases
暂时只支持Windows,后续会逐步完善多平台兼容性。
也可以本地跑:
git clone https://github.com/yyy-router/RAGPeek.git
cd RAGPeek
npm install
npm run dev
怎么开发
Electron + Vue 3 + TypeScript,UI 用的 Naive UI。三个进程的标准结构:
src/
├── main/ # 主进程(IPC、ChromaDB 客户端、SQLite)
├── preload/ # contextBridge 暴露 API
└── renderer/ # 渲染进程(Vue 3)
开发跑 npm run dev,构建跑 npm run build。
说在最后
这个工具目前还在持续迭代,后面计划加测试集管理、指标评测、Embedding 可视化。
如果你也在用 ChromaDB,欢迎试试,觉得有用的话给个 Star,有 Bug 提 Issue 或者直接 PR。
GitHub: https://github.com/yyy-router/RAGPeek
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐


所有评论(0)