客户端-服务器模式

Chroma 也可以配置为以客户端/服务器模式运行。在此模式下，Chroma 客户端连接到在独立进程中运行的 Chroma 服务器。要启动 Chroma 服务器，请运行以下命令：

chroma run --path /db_path

Python
TypeScript
Rust

然后使用 Chroma HttpClient 连接到服务器

import chromadb

chroma_client = chromadb.HttpClient(host='localhost', port=8000)

就这么简单！只需进行这一更改，Chroma 的 API 就会在 client-server 模式下运行。Chroma 还提供了异步 HTTP 客户端。其行为和方法签名与同步客户端完全相同，但所有会阻塞的方法现在都是异步的。要使用它，请改为调用 AsyncHttpClient：

import asyncio
import chromadb

async def main():
    client = await chromadb.AsyncHttpClient()

    collection = await client.create_collection(name="my_collection")
    await collection.add(
        documents=["hello world"],
        ids=["id1"]
    )

asyncio.run(main())

如果您部署了 Chroma 服务器，您还可以使用我们的 http-only 软件包。

然后您可以通过实例化一个新的 ChromaClient 来连接到它

import { ChromaClient } from "chromadb";

const client = new ChromaClient();

如果您使用不同的配置运行 Chroma 服务器，或者部署了您的 Chroma 服务器，您可以指定 host、port 以及客户端是否应通过 ssl 连接

import { ChromaClient } from "chromadb";

const client = new ChromaClient({
  host: "YOUR-HOST",
  port: "YOUR-PORT",
  ssl: true,
});

您可以通过实例化一个新的 ChromaHttpClient 来连接到它

let options = ChromaHttpClientOptions {
    endpoint: "https://:8000".parse()?,
    ..Default::default()
};
let client = ChromaHttpClient::new(options);

概述

运行 Chroma

集合 (Collections)

查询集合

向量嵌入 (Embeddings)

命令行界面 (CLI)

客户端-服务器模式