Chroma 教程 收藏

用 CLI 起服务

🎉摘要:Chroma CLI 是 Chroma 向量库自带的命令行工具,无需写 Python 代码即可在终端操作 Chroma。本文详解 chroma run 命令启动本地服务的方法,包括指定存储路径、端口、监听地址、配置文件使用及服务验证方式。

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"

 

说说我的看法
全部评论()
没有评论
关于
本网站专注于 Java、数据库(MySQL、Oracle)、Linux、软件架构及大数据等多领域技术知识分享。涵盖丰富的原创与精选技术文章,助力技术传播与交流。无论是技术新手渴望入门,还是资深开发者寻求进阶,这里都能为您提供深度见解与实用经验,让复杂编码变得轻松易懂,携手共赴技术提升新高度。如有侵权,请来信告知:hxstrive@outlook.com
其他应用
公众号