Repository navigation
2.22.0
ChromaDotNet.Client, ChromaDotNet.Client.DependencyInjection, ChromaDotNet.Client.Backup and ChromaDotNet.Client.Cli 2.22.0, released together.
Backup and restore (new)
- ChromaDotNet.Client.Backup saves collections of a database into a zip file through the API of Chroma, writes them back into the same server or another one, and compares a file with a database. See Backup and restore.
- ChromaDotNet.Client.Cli is the command
chromadotnet, withbackup,restoreandverify, as a .NET tool: it needs .NET 10 or later. - Each release also has the command as a file that runs without .NET, for linux-x64, linux-arm64, linux-musl-x64, osx-arm64, osx-x64 and win-x64, with their SHA-256 in
SHA256SUMSand a Sigstore signature for each. The files for Linux with glibc need glibc 2.34 or later. - The image
ghcr.io/chromadotnet/chromadotnet:2.22.0has the file for musl x64 on Alpine, for linux/amd64 only, signed by its digest and with its build provenance. - If the server takes writes during a backup, the file can hold records of different moments: the command says so and exits with 2.
- Tested with Chroma 1.5.9, VecturaDB 1.0.0-preview.9 and Chroma Cloud, also from each one into the others. Distributed Chroma installed by yourself: not tested.
Client
ChromaCollectionDefinition.SchemaJsoncreates a collection with the exact JSON of a schema.ChromaException.RetryAfter: the wait that the server asked for withRetry-After, or null when it sent none.
In our tests on 15 November 2026, the suite passed on .NET 10 against Chroma 0.4.10, 0.4.15, 0.4.23, 0.5.15, 0.5.16, 0.5.20, 0.6.3, 1.0.0 and 1.5.9, and on .NET 11 against 1.5.9. It passed on .NET 10 against VecturaDB 1.0.0-preview.9, with backups restored from VecturaDB into Chroma 1.5.9 and back. It passed against the .NET Standard 2.0 build on .NET 10, and on .NET Framework 4.8 the tests of the runtime passed. An application on .NET 8 and one on .NET 9 built with the package, and the trimmed and NativeAOT builds had no warnings. The command from the package, the library on .NET 10 and on .NET 8, and the native files for win-x64, linux-x64 and linux-musl-x64, the last one in the image, made a backup, a restore and a verification between Chroma 1.5.9 and VecturaDB 1.0.0-preview.9; the command also between Chroma 1.5.9 and Chroma Cloud. The CI ran the native files for Linux against Chroma 1.5.9, and the ones for macOS and Windows only with --version.
Nothing is removed or changed in the public API: it only grows.
NuGet: https://www.nuget.org/packages/ChromaDotNet.Client/2.22.0, https://www.nuget.org/packages/ChromaDotNet.Client.DependencyInjection/2.22.0, https://www.nuget.org/packages/ChromaDotNet.Client.Backup/2.22.0 and https://www.nuget.org/packages/ChromaDotNet.Client.Cli/2.22.0