# chroma-cloud

Guides building semantic and hybrid search on Chroma Cloud, covering managed collections, cloud clients, schemas and the Chroma CLI.

Skill by Chroma. Category: Data and backend.

## Install

Project (for this project only):

```sh
npx skills add chroma-core/agent-skills --skill chroma-cloud
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add chroma-core/agent-skills --skill chroma-cloud -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Warn
- ZeroLeaks: Pass

Installs: 69. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/chroma-core/agent-skills/chroma-cloud)

## Source

[Open the source](https://github.com/chroma-core/agent-skills/tree/HEAD/src/chroma-cloud). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: chroma-cloud
description: Provides expertise on Chroma Cloud integration for semantic search and hybrid search applications. Use when the user is working with Chroma Cloud, CloudClient, managed collections, Schema(), Search(), hybrid search, or Chroma Cloud CLI workflows.
---

## Instructions

### Intake

Do not block on a long questionnaire. Ask only for details that are missing and required to choose the right path:

- Dense only or hybrid search
- Whether `CHROMA_API_KEY`, `CHROMA_TENANT`, and `CHROMA_DATABASE` are already configured
- Existing embedding choice, if any

If the user has no embedding preference, default to Chroma Cloud Qwen. If hybrid search is required, use `Schema()` and `Search()`. If the task is narrow, such as fixing an existing query, reviewing code, or answering an API question, proceed with the repo context instead of forcing intake.

### What to validate

- Correct client import (`CloudClient` vs `Client`)
- Environment variables are set for Cloud deployments
- Embedding function package is installed when the selected TypeScript embedding requires one
- `Schema()` and `Search()` are only used for Cloud workflows
- **Important:** `get_or_create_collection()` accepts either an `embedding_function` OR a `schema`, but not both. Use `schema` when you need multiple indexes, hybrid search, or sparse embeddings; use `embedding_function` for simple dense-only search.

## Quick Start

Use the CLI topic to authenticate and write Cloud credentials:

```bash
chroma login
chroma db create <db_name>
chroma db connect <db_name> --env-file
```

Then create a `CloudClient` and choose the API based on the search mode:

```typescript
import { CloudClient } from 'chromadb';

const client = new CloudClient();
const collection = await client.getOrCreateCollection({ name: 'my_collection' });
```

Use `collection.query()` for dense-only search. Use `Schema()` plus `Search()` only when the user needs hybrid retrieval, multiple indexes, or more expressive ranking/query composition.

## Cloud Guidance

Collections are the main isolation boundary in Chroma Cloud, and metadata is the main filtering mechanism inside a collection. Reach for `Schema()` only when you need explicit dense+sparse or multi-index configuration, and reach for `Search()` only when `query()` is not expressive enough.

## Learn More

If you need more detailed information about Chroma beyond what's covered in this skill, fetch Chroma's llms.txt for comprehensive documentation: https://docs.trychroma.com/llms.txt

## Available Topics

### Typescript

- [Chroma Regex Filtering](./regex/typescript.md) - Learn how to use regex filters in Chroma queries
- [Query and Get](./querying/typescript.md) - Query and Get Data from Chroma Collections
- [Metadata](./metadata/typescript.md) - Store and query metadata, including filters and array values
- [Updating and Deleting](./updating-deleting/typescript.md) - Update existing documents and delete data from collections
- [Schema](./schema/typescript.md) - Schema() configures collections with multiple indexes
- [Chroma Cloud Qwen](./chroma-cloud-qwen/typescript.md) - Chroma's hosted Qwen embedding service
- [Error Handling](./error-handling/typescript.md) - Handling errors and failures when working with Chroma
- [Collection Forking](./forking/typescript.md) - Instantly duplicate collections using copy-on-write forking in Chroma Cloud
- [Search() API](./search-api/typescript.md) - An expressive and flexible API for doing dense and sparse vector search on collections, as well as hybrid search

### Python

- [Chroma Regex Filtering](./regex/python.md) - Learn how to use regex filters in Chroma queries
- [Query and Get](./querying/python.md) - Query and Get Data from Chroma Collections
- [Metadata](./metadata/python.md) - Store and query metadata, including filters and array values
- [Updating and Deleting](./updating-deleting/python.md) - Update existing documents and delete data from collections
- [Schema](./schema/python.md) - Schema() configures collections with multiple indexes
- [Chroma Cloud Qwen](./chroma-cloud-qwen/python.md) - Chroma's hosted Qwen embedding service
- [Error Handling](./error-handling/python.md) - Handling errors and failures when working with Chroma
- [Collection Forking](./forking/python.md) - Instantly duplicate collections using copy-on-write forking in Chroma Cloud
- [Search() API](./search-api/python.md) - An expressive and flexible API for doing dense and sparse vector search on collections, as well as hybrid search

## General

- [Data Model](./data-model.md) - An overview of how Chroma stores data
- [Integrating Chroma into an existing system](./understanding-a-codebase.md) - Guidance for adding Chroma search to an existing application
- [Chroma CLI](./cli.md) - Getting started with the Chroma CLI for Chroma Cloud authentication and database management
- [Caching Collection References](./caching-collections.md) - Reduce repeated collection lookup requests in high-traffic Chroma Cloud applications
- [Quotas and Limits](./quotas.md) - Chroma Cloud quotas and request limits
````

- Previous: [chroma-local](https://syn4pse.dev/terminal/chroma-local.md)
- Next: [speech-to-text](https://syn4pse.dev/terminal/deepgram-speech-to-text.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
