cli-anything-chromadb 是一个面向 ChromaDB 向量数据库的无状态命令行接口(stateless CLI),构建于 ChromaDB 的 HTTP API v2 之上。其定位是让 AI 智能体与高级用户无需浏览器 UI,即可完成集合管理、文档管理和语义查询等操作。
用途方面,该工具主要用于以命令行方式操作 ChromaDB 服务,覆盖服务器状态检查、集合(collection)的增删查、文档(document)的增删查与计数,以及基于文本的语义搜索。它被明确设计给 AI 智能体与需要脚本化操作数据库的高级用户使用。
主要能力以命令组划分: server 组提供服务器相关的健康与版本信息,包括 heartbeat(检查 ChromaDB 服务器健康状态)与 version(获取服务器版本)。 collection 组用于管理集合,包括 list(列出全部集合)、create --name NAME(创建集合)、delete --name NAME(删除集合)、info NAME(查看集合信息)。 document 组用于管理集合中的文档,包括 add --collection C --id ID --document TEXT(添加文档)、get --collection C(获取文档)、delete --collection C --id ID(删除文档)、count --collection C(统计文档数量)。 query 组用于对集合执行语义搜索,命令为 search --collection C --text T。
使用方式方面,该 CLI 随 cli-anything-chromadb 包一起安装,安装命令为:pip install cli-anything-chromadb。运行前提是 Python 3.10+,并且 ChromaDB 服务器运行在 localhost:8000;如需连接其他实例,可通过 --host 参数指定。基本用法包括:使用 --help 查看帮助;直接运行而不带子命令时进入交互式 REPL 会话,支持 Tab 补全与历史记录;也可直接以子命令形式执行,例如使用 --json server heartbeat 检查服务器健康、使用 --json collection list 列出集合、使用 --json query search --collection hub_knowledge --text "How to deploy" 执行语义搜索。
输出格式支持双模式:默认的人类可读输出使用表格、颜色与格式化文本;添加 --json 标志后输出结构化 JSON,便于智能体消费。资料还给出了面向 AI 智能体的使用建议:编程调用时始终使用 --json 标志以获得可解析输出;检查返回码,0 表示成功、非零表示错误;失败时解析 stderr 获取错误信息;使用 --host 连接非默认的 ChromaDB 实例。
适用场景上,该工具适合需要在自动化流程、脚本或智能体工作流中管理 ChromaDB 集合与文档、执行语义检索的用户。限制方面,资料显示其依赖运行中的 ChromaDB 服务器与 Python 3.10+ 环境,版本为 1.0.0;其余性能、收费、价格、检索效果等信息暂未提供。