Advanced Analytica Advanced Analytica: IBOM
← All connectors
Chroma logo

Destination connector

Chroma

Send governed data into Chroma with a clear, practical setup guide.

Version 0.0.56 community alpha

Chroma

Set up the Chroma destination connector using this guide.

Output schema

One stream collects data from all source streams. It exists in a collection in Chroma. You define its name, which Airbyte validates and corrects.

Each record receives a generated UUID string as its document id. The defined embeddings are stored as embeddings. Text field data is stored as documents. Metadata field data is stored as metadata.

Supported sync modes

Sync modeSupported?
Full Refresh - OverwriteYes
Full Refresh - AppendYes
Full Refresh - Overwrite + DedupedYes
Incremental Sync - AppendYes
Incremental Sync - Append + DedupedYes

Get started (Airbyte Open Source)

You can connect to a Chroma instance in client/server mode or local persistent mode. In local persistent mode, the database file is saved at the path defined by the path config parameter. path must be an absolute path prefixed with /local.

:::danger

Kubernetes doesn’t support Persistent Client mode.

:::

By default, the LOCAL_ROOT env variable in the .env file is set to /tmp/airbyte_local.

Docker mounts the local mount onto LOCAL_ROOT. By default, this substitutes /local with /tmp/airbyte_local.

:::caution

Make sure Docker Desktop can access /tmp. On MacOS, it must also access /private because /tmp links to /private. Otherwise, it won’t work. Allow access through “File sharing” in Settings -> Resources -> File sharing -> add the one or two above folder, then select “Apply & restart”.

:::

Requirements

To use the Chroma destination, you’ll need:

  • An account with API access for OpenAI or Cohere, depending on your chosen embedding method. You don’t need one for default chroma embedding function.
  • A Chroma db instance in client/server mode or persistent mode
  • Credentials for client/server mode
  • A Local File path for Persistent mode

Configure network access

Make sure Airbyte can access your Chroma database. If it’s within a VPC, allow access from the IP you’re using to expose Airbyte.

Set up the Chroma destination in Airbyte

You now have everything needed to configure Chroma as a destination in the UI. You’ll need the following information:

  • (Required) Text fields to embed
  • (Optional) Text splitter Options for configuring the chunking process provided by the Langchain Python library.
  • (Required) Fields to store as metadata
  • (Required) Collection The Chroma db collection name for storing your data
  • (Required) Authentication method
    • For client/server mode
      • Host, for example localhost
      • Port, for example 8000
      • Username (Optional)
      • Password (Optional)
    • For persistent mode
      • Path The path to the local database file. path must be an absolute path prefixed with /local.
  • (Optional) Embedding
    • OpenAI API key when using OpenAI for embedding
    • Cohere API key when using Cohere for embedding
    • Embedding Field name and Embedding dimensions when getting embeddings from stream records

Namespace support

This destination supports namespaces.

Changelog

Expand to review
VersionDatePull RequestSubject
0.0.562026-10-0788197Fix username/password (client/server mode) connections failing with No module named chromadb.auth.basic by using the chromadb.auth.basic_authn.BasicAuthClientProvider path required by chromadb 0.5+
0.0.552026-08-1384361Update the CDK to remediate CVE-2025-68664 in the langchain dependency
0.0.542025-05-0359326Update dependencies
0.0.532025-04-2658256Update dependencies
0.0.522025-04-1257652Update dependencies
0.0.512025-04-0557169Update dependencies
0.0.502025-03-2956624Update dependencies
0.0.492025-03-2256120Update dependencies
0.0.482025-03-0855393Update dependencies
0.0.472025-03-0154852Update dependencies
0.0.462025-02-2254209Update dependencies
0.0.452025-02-1553930Update dependencies
0.0.442025-02-0853428Update dependencies
0.0.432025-02-0152941Update dependencies
0.0.422025-01-2552189Update dependencies
0.0.412025-01-1851744Update dependencies
0.0.402025-01-1151296Update dependencies
0.0.392025-01-0450913Update dependencies
0.0.382024-12-2850445Update dependencies
0.0.372024-12-2150221Update dependencies
0.0.362024-12-1448956Update dependencies
0.0.352024-11-2548668Update dependencies
0.0.342024-11-0448236Update dependencies
0.0.332024-10-2947053Update dependencies
0.0.322024-10-1246434Update dependencies
0.0.312024-09-2846192Update dependencies
0.0.302024-09-2145553Update dependencies
0.0.292024-09-0745322Update dependencies
0.0.282024-08-3145017Update dependencies
0.0.272024-08-2444717Update dependencies
0.0.262024-08-2244530Update test dependencies
0.0.252024-08-1744292Update dependencies
0.0.242024-08-1243734Update dependencies
0.0.232024-08-1043702Update dependencies
0.0.222024-08-0343133Update dependencies
0.0.212024-07-2742628Update dependencies
0.0.202024-07-2042160Update dependencies
0.0.192024-07-1341802Update dependencies
0.0.182024-07-1041384Update dependencies
0.0.172024-07-0941165Update dependencies
0.0.162024-07-0640926Update dependencies
0.0.152024-06-2940634Update dependencies
0.0.142024-06-2740215Replaced deprecated AirbyteLogger with logging.Logger
0.0.132024-06-2540431Update dependencies
0.0.122024-06-2340222Update dependencies
0.0.112024-06-2240068Update dependencies
0.0.102024-04-15#37333Updated CDK & pytest version to fix security vulnerabilities
0.0.92023-12-11#33303Fix bug with embedding special tokens
0.0.82023-12-01#32697Allow omitting raw text
0.0.72023-11-16#32608Support deleting records for CDC sources
0.0.62023-11-13#32357Improve spec schema
0.0.52023-10-23#31563Add field mapping option
0.0.42023-10-15#31329Add OpenAI-compatible embedder option
0.0.32023-10-04#31075Fix OpenAI embedder batch size
0.0.22023-09-29#30820Update CDK
0.0.12023-09-08#30023🎉 New Destination: Chroma (Vector Database)
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.