Chroma¶
Chroma is an open-source vector database for AI applications. It stores embeddings together with their documents and metadata, and runs nearest neighbor queries against them.
Add the following dependency to your project file:
| NuGet | |
|---|---|
1 | |
You can start a Chroma container instance from any .NET application. Here, we create different container instances and pass them to the base test class. This allows us to test different configurations.
1 2 3 4 5 6 7 8 | |
This example uses xUnit.net's IAsyncLifetime interface to manage the lifecycle of the container. The container is started in the InitializeAsync method before the test method runs, ensuring that the environment is ready for testing. After the test completes, the container is removed in the DisposeAsync method.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 | |
The test example creates a collection, adds two records, and queries the record nearest to an embedding. Use GetBaseAddress() to configure the Chroma client.
The test example uses the following NuGet dependencies:
1 2 3 4 5 | |
To execute the tests, use the command dotnet test from a terminal.
Tip
For the complete source code of this example and additional information, please refer to our test projects.
Default configuration¶
The builder applies the following default configuration:
- Port:
8000(seeChromaBuilder.ChromaPort) - Wait strategy: Waits until the heartbeat endpoint responds successfully.