Chroma GUI - Chroma 向量数据库可视化管理工具

Chroma GUI - Chroma 向量数据库可视化管理工具

前言

下载地址在最下边

最近在用 Chroma 做向量数据库开发，每次插入数据后都要写代码查询验证：

collection.get()  # 数据插进去了吗？
collection.query(...)  # 搜索能召回吗？

集合多了之后，哪个集合存了什么数据、文档内容对不对、向量维度对不对……全靠代码猜，非常不方便。

于是花了点时间，写了一个可视化调试工具——Chroma GUI。

它能做什么

1. 多配置管理

同时管理多个 Chroma 实例（本地 / 远程 / 测试 / 生产），一键切换，不用改代码。

2. 集合浏览

查看所有集合、文档数量、HNSW 索引配置（ef_construction、ef_search、M 等参数一目了然）。

3. 文档查看

分页浏览文档内容、元数据、向量维度，再也不用写 Python 脚本查数据了。

4. 文档增删改

直接在界面上添加 / 编辑 / 删除文档，支持元数据和向量数据。

5. 向量搜索

粘贴查询向量 JSON 数组，执行相似度搜索，查看距离分数和排名——验证召回率最直接的方式。

6. 元数据过滤

输入 {"category": "tech"} 或 {"score": {"$gt": 80}} 筛选文档，支持 Chroma 全部过滤操作符。

7. 暗色主题 + 中英文切换

写代码写到半夜，暗色模式对眼睛友好。

技术实现

• Go 后端：静态文件嵌入 + API 代理（解决 CORS 跨域问题）
• 前端：原生 JS，无框架依赖
• 单文件部署：编译后一个可执行文件，双击运行，自动打开浏览器

没有 Node.js、没有 Webpack、没有 npm install，就是简单直接。

快速使用

# 从源码编译
go build -o chroma-gui .
./chroma-gui

# 或下载预编译版本
# Windows: 双击 .exe 即可
# macOS / Linux: ./chroma-gui

浏览器自动打开 http://localhost:8888，填上 Host/Port 就能用了。

截图

开源/下载 地址

GitHub: https://github.com/sqalongl/chroma-gui

欢迎提 Issue 和 PR，也欢迎 Star ⭐ 支持！

如果这个工具帮到了你，欢迎请我喝杯咖啡 ☕