Skip to content

2.22.0

Choose a tag to compare

@Laurianti Laurianti released this 15 Nov 21:01
e87a848

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, with backup, restore and verify, 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 SHA256SUMS and 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.0 has 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.SchemaJson creates a collection with the exact JSON of a schema.
  • ChromaException.RetryAfter: the wait that the server asked for with Retry-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