Run a Chroma Server ↗

Documentation Index#

Fetch the complete documentation index at: https://docs.trychroma.com/llms.txt Use this file to discover all available pages before exploring further.

Run a Chroma server locally using the CLI.

The Chroma CLI lets you run a Chroma server locally with the chroma run command:

chroma run --path [/path/to/persist/data]

Your Chroma server will persist its data in the path you provide after the path argument. By default, it will save data to the chroma directory.

You can further customize how your Chroma server runs with these arguments:

• host - defines the hostname where your server runs. By default, this is localhost.
• port - the port your Chroma server will use to listen for requests from clients. By default the port is 8000.
• config_path - instead of providing path, host, and port, you can provide a configuration file with these definitions and more. You can find an example here.

Connecting to your Chroma Server#

With your Chroma server running, you can connect to it with the HttpClient:

import chromadb

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

import { ChromaClient } from "chromadb";

const client = new ChromaClient();