Chroma CLI 是 Chroma 向量库自带的命令行工具(chroma 命令),用来在终端操作 Chroma,不用写 Python 代码。 它和 Python SDK 是两套东西:Python SDK 写业务逻辑;CLI 偏向运维、服务启动、数据查看、迁移、云账号管理。
注意:Chroma CLI 是随 chromadb Python 包自带的命令行程序,你装完 chromadb 就自带 chroma 命令,不用额外单独装二进制(也提供独立 Rust 二进制安装方式)。
我本机的 CLI 版本:

可以使用 chroma run 命令快速启动一个 chromadb 服务,默认使用当前工作目录下的 ./chroma 文件夹存数据 ,如下图:

当前目录下面 chroma 目录如下,仅存在一个 chroma.sqlite3:

如果你不想将数据存储到当前目录,可以通过 --path 指定存储位置(chroma run --path D:/tmp/chroma),如下:

运行 chroma run --help 命令查看 chroma run 的完整参数:
C:\Users\Administrator> chroma run --help
Start a local Chroma server
启动本地 Chroma 服务
Usage: chroma run [OPTIONS] [CONFIG_PATH]
用法:chroma run [选项] [配置文件路径]
Arguments:
[CONFIG_PATH] The path to the Chroma config file
Chroma 配置文件的路径
Options:
--path <PATH> The persistence path to your Chroma DB
Chroma 数据库持久化存储目录
--host <HOST> The host to listen to. Default: localhost [default: localhost]
监听地址。默认:localhost [默认值:localhost]
--port <PORT> The port to run the server on
服务监听端口
-h, --help Print help
打印帮助信息常用组合:
# 默认:localhost:8000,数据落在 ./chroma
chroma run
# 指定数据目录和端口
chroma run --path ./chroma_data --port 8001
# 允许外部访问(注意:这样谁都能连,配合防火墙或反向代理用)
chroma run --path ./chroma_data --host 0.0.0.0 --port 8000
# 用配置文件
chroma run ./config.yaml起完之后验证:
C:\Users\Administrator> curl http://localhost:8000/api/v2/heartbeat
{"nanosecond heartbeat":1794292459388492600}返回一个纳秒时间戳就说明活了。
顺便看看版本:
C:\Users\Administrator> curl http://localhost:8000/api/v2/version
"1.0.0"