CLI Commands

pip install chromadb

chroma --help     # Show help information
chroma --version  # Show CLI version (current: 1.4.1)

chroma run [config_path] [options]

# Run with default settings (localhost:8000)
chroma run

# Run on custom port
chroma run --port 9000

# Run with custom data path
chroma run --path ./my-chroma-data

# Run with config file
chroma run /path/to/config.yaml

# Run on all interfaces
chroma run --host 0.0.0.0 --port 8000

chroma db <subcommand> [options]

chroma db create [name] [options]

chroma db create my-database
chroma db create  # Interactive prompt

chroma db list [options]

chroma db list

chroma db connect [name] [options]

# Get Python connection snippet
chroma db connect my-database --language python

# Get JavaScript snippet
chroma db connect my-database --language javascript

# Create .env file
chroma db connect my-database --env-file

# Output environment variables
chroma db connect my-database --env-vars

chroma db delete [name] [options]

chroma db delete my-database
chroma db delete my-database --force  # Skip confirmation

chroma browse <collection_name> [options]

# Browse a cloud collection
chroma browse my_collection --db my-database

# Browse a local collection
chroma browse my_collection --local

# Browse with custom theme
chroma browse my_collection --theme Light

# Browse from custom host
chroma browse my_collection --host http://localhost:9000

# Browse from custom path
chroma browse my_collection --path ./my-chroma-data

chroma copy [options]

# Copy all collections from local to cloud
chroma copy --from-local --to-cloud --all --db my-database

# Copy specific collections
chroma copy --collections my_collection --collections another_collection --to-cloud --db my-database

# Copy from cloud to local with custom batch size
chroma copy --from-cloud --to-local --all --db my-database --batch 200

# Copy with custom concurrency
chroma copy --from-local --to-cloud --all --concurrent 8 --db my-database

chroma login [options]

# Interactive browser login
chroma login

# Login with custom profile name
chroma login --profile my-team

# Headless login (requires both --api-key and --profile)
chroma login --api-key YOUR_API_KEY --profile my-profile

chroma profile <subcommand> [options]

chroma profile list

chroma profile show

chroma profile use <name>

chroma profile use my-team

chroma profile delete <name> [options]

chroma profile delete old-profile
chroma profile delete current-profile --force

chroma profile rename <name> <new_name>

chroma profile rename old-name new-name

chroma vacuum [options]

# Vacuum default location
chroma vacuum

# Vacuum custom path
chroma vacuum --path ./my-chroma-data

# Force vacuum without confirmation
chroma vacuum --force

# Vacuum with timeout
chroma vacuum --timeout 300

chroma install [name] [options]

# List available sample apps
chroma install --list

# Install a sample app
chroma install my-sample-app

# Install for local development
chroma install my-sample-app --local

# Install for cloud with database
chroma install my-sample-app --db my-database

chroma update

chroma docs

chroma support