cli-anything-chromadb 是做什么的？
基于 HTTP API v2 构建的无状态 ChromaDB 向量数据库命令行界面。专为 AI 代理和高级用户设计，无需浏览器 UI 即可管理集合、文档并运行语义查询。
安装
此 CLI 作为 cli-anything-chromadb 软件包的一部分安装：
pip install cli-anything-chromadb
前置条件：
- Python 3.10+
- 在 localhost:8000 运行的 ChromaDB 服务器（或通过 --host 指定）
用法
基本命令
# 显示帮助
cli-anything-chromadb --help
# 启动交互式 REPL 模式
cli-anything-chromadb
# 检查服务器健康状态
cli-anything-chromadb --json server heartbeat
# 列出所有集合
cli-anything-chromadb --json collection list
# 语义搜索
cli-anything-chromadb --json query search --collection hub_knowledge --text "如何部署"
REPL 模式
如果未指定子命令，CLI 会进入交互式 REPL 会话：
cli-anything-chromadb
# 使用 tab 补全和历史记录交互式输入命令
命令组
server
服务器健康状态和版本命令。
| 命令 | 描述 |
|---|---|
heartbeat | 检查 ChromaDB 服务器健康状态 |
version | 获取 ChromaDB 服务器版本 |
collection
管理 ChromaDB 集合。
| 命令 | 描述 |
|---|---|
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 | 语义搜索 |
输出格式
所有命令均支持双输出模式：
- 人类可读（默认）：表格、彩色、格式化文本
- 机器可读（
--json标志）：结构化 JSON，供代理消费
# 人类输出
cli-anything-chromadb server heartbeat
# 供代理使用的 JSON 输出
cli-anything-chromadb --json server heartbeat
针对 AI 代理
在编程方式使用此 CLI 时：
- 始终使用
--json标志 以获得可解析的输出 - 检查返回码 - 0 表示成功，非零表示错误
- 解析 stderr 以获取失败时的错误信息
- 使用
--host连接到非默认 ChromaDB 实例
版本
1.0.0