Skip to content

2.21.0

Choose a tag to compare

@Laurianti Laurianti released this 13 Nov 20:57
· 28 commits to main since this release
v2.21.0
bb6dd70

ChromaDotNet.Client and ChromaDotNet.Client.DependencyInjection 2.21.0, released together.

.NET 10 and .NET 11

  • The packages build for .NET 10 instead of .NET 8, which went out of support on 10 November 2026 with .NET 9. Applications on .NET 10 and on .NET 11 take the .NET 10 build.
  • The CI runs the tests on .NET 10 against every tested Chroma version, and on .NET 11 against Chroma 1.5.9. It publishes a test app with trimming and with NativeAOT on both, every warning an error.

.NET 8 and .NET 9

  • Applications on .NET 8 and 9 now take the .NET Standard 2.0 build. It has the same public API as the others, the embedding generators of Microsoft.Extensions.AI included, and it advises the buckets of db.client.operation.duration.
  • The HttpClient of a client created without one renews its connections every two minutes, as before, and ChromaMetadataConvert still writes and reads DateOnly. The build finds SocketsHttpHandler and DateOnly in the runtime.
  • The .NET Standard 2.0 build cannot be marked IsAotCompatible. In our tests, an app on .NET 8 published with trimming and with NativeAOT, every warning an error, ran against Chroma 1.5.9 on it.
  • New dependencies of that build: System.Text.Json 8.0.6 and System.Memory 4.5.5, next to Microsoft.Extensions.AI.Abstractions 9.5.0 and System.Diagnostics.DiagnosticSource 9.0.20.

.NET Core 3.1 to 7

  • They take the same build, and get the embedding generators.
  • System.Diagnostics.DiagnosticSource 9.0.20 warns at build that it does not support these versions. On .NET 6 and 7 the warning is new in this release. On .NET Core 3.1 and .NET 5 there was one before. In our tests on 13 November 2026 the client ran on all four against Chroma 1.5.9. <SuppressTfmSupportBuildWarnings>true</SuppressTfmSupportBuildWarnings> in the project file turns the warning off.

VecturaDB

  • The CI runs the tests against VecturaDB 1.0.0-preview.9.
  • The documentation of ChromaWriteRetries says which writes VecturaDB refuses with a Retry-After: those to a SPANN collection.

In our tests on 12 November 2026, the suite passed on .NET 10 against Chroma 0.4.10, 0.4.15, 0.4.23, 1.0.0 and 1.5.9, and on .NET 11 against 1.5.9. It passed against the .NET Standard 2.0 build on .NET 10 and on the .NET 8.0.34 runtime, and on .NET Framework 4.8. On 13 November 2026 it passed on .NET 10 against VecturaDB 1.0.0-preview.9.

The public API of every application stays the same or grows. On .NET Core 3.1 to 7, a build that turns warnings into errors stops at the warning of System.Diagnostics.DiagnosticSource, unless it sets SuppressTfmSupportBuildWarnings.

NuGet: https://www.nuget.org/packages/ChromaDotNet.Client/2.21.0 and https://www.nuget.org/packages/ChromaDotNet.Client.DependencyInjection/2.21.0