chromadb 1.0.1

Dart client for the ChromaDB vector database API - the open-source embedding database for AI applications.

1.0.1

Unified equality helpers across packages and updated dependencies.

• REFACTOR: Unify equality_helpers.dart across packages (#67). (ec2897f8)
• CHORE: Bump googleapis from 15.0.0 to 16.0.0 and Dart SDK to 3.9.0 (#52). (eae130b7)
• CI: Add GitHub Actions test workflow (#50). (6c5f079a)

1.0.0

Note: This release has breaking changes.

TL;DR: Complete reimplementation with a new architecture, minimal dependencies, unified resource-based API, and full ChromaDB v2 API coverage. Includes new Search API, Functions, multi-tenant management, automatic retry, and comprehensive exception handling.

What's new

• Complete ChromaDB v2 API coverage: All endpoints implemented.
  • Collections API: create, get, list, update, delete, count, fork.
  • Records API: add, update, upsert, get, query, search, delete, count.
  • Search API: Advanced hybrid search with filtering, grouping, ranking, and pagination.
  • Functions API: attach, get, detach serverless functions.
  • Multi-tenant: Full tenant and database management.
  • Health API: heartbeat, version, pre-flight checks, healthcheck, reset.
  • Auth API: User identity retrieval.
• Architecture:
  • Interceptor chain (Auth → Logging → Error).
  • Authentication: API key, Bearer token, custom OAuth via AuthProvider.
  • Retry with exponential backoff + jitter (configurable RetryPolicy).
  • Central ChromaConfig (timeouts, retry policy, log level, baseUrl, tenant, database).
• High-level wrapper (ChromaCollection):
  • Automatic embedding generation from documents, images, or URIs.
  • Convenient query methods accepting text instead of embeddings.
  • DataLoader interface for loading content from URIs.
  • Input validation and error handling.
• Convenience constructors: ChromaClient.local(), ChromaClient.withApiKey().
• Minimal dependencies: Only http and logging.
• Testing: 200+ unit tests covering models, resources, and error handling.

Breaking Changes

• Resource-based API: Methods reorganized under strongly-typed resources:
  • client.health.* (heartbeat, version, healthcheck, reset)
  • client.collections.* (low-level collection CRUD)
  • client.records(collectionId).* (record operations)
  • client.functions(collectionId).* (serverless functions)
  • client.tenants.*, client.databases.* (multi-tenant)
  • client.auth.* (identity)
• Configuration: New ChromaConfig with AuthProvider pattern (API key / bearer / custom).
• Collection wrapper: Collection class renamed to ChromaCollection.
• Metadata access: collection.metadata → collection.metadata.metadata for custom metadata.
• Modify parameters: name → newName, metadata → newMetadata.
• Health methods moved: client.heartbeat() → client.health.heartbeat().
• Return types: Primitives replaced with response objects (HeartbeatResponse, VersionResponse).
• Default includes changed: get(), peek(), query() no longer include embeddings by default.
• Exceptions: Replaced ChromaApiClientException with typed hierarchy:
  • ApiException, AuthenticationException, NotFoundException, ConflictException, RateLimitException, ServerException, ValidationException, TimeoutException, AbortedException.

See MIGRATION.md for step-by-step examples and mapping tables.

Commits

• BREAKING FEAT: Complete v1.0.0 reimplementation (#9). (caae5d24)
• FEAT: Add support for custom HTTP headers (#20). (c1cc81cd)
• REFACTOR: Align client package architecture across SDK packages (#37). (cf741ee1)
• REFACTOR: Align API surface across all SDK packages (#36). (ed969cc7)
• DOCS: Pre-release documentation fixes (#43). (f16aab76)
• DOCS: Refactors repository URLs to new location. (76835268)

0.3.0+1

• REFACTOR: Fix pub format warnings (#809). (640cdefb)

0.3.0

Note: This release has breaking changes.

• FEAT: Upgrade to http v1.5.0 (#785). (f7c87790)
• BREAKING BUILD: Require Dart >=3.8.0 (#792). (b887f5c6)

0.2.3

• FEAT: Migrate to Freezed v3 (#773). (f87c8c03)

0.2.2

• BUILD: Update dependencies (#751). (250a3c6)

0.2.1

• FEAT: Update dependencies (requires Dart 3.6.0) (#709). (9e3467f7)
• REFACTOR: Remove fetch_client dependency in favor of http v1.3.0 (#659). (0e0a685c)
• FIX: Fix linter issues (#656). (88a79c65)

0.2.0+2

• REFACTOR: Add new lint rules and fix issues (#621). (60b10e00)
• REFACTOR: Upgrade api clients generator version (#610). (0c8750e8)

0.2.0+1

• FIX: Fix deserialization of sealed classes (#435). (7b9cf223)

0.2.0

• FIX: Have the == implementation use Object instead of dynamic (#334). (89f7b0b9)

0.1.2

• FEAT: Update meta and test dependencies (#331). (912370ee)

0.1.1+1

• DOCS: Update CHANGELOG.md. (d0d46534)

0.1.1

• Update a dependency to the latest release.

0.1.0+2

• FIX: Decode JSON responses as UTF-8 (#234) (#235). (29347763)

0.1.0+1

• DOCS: Add public_member_api_docs lint rule and document missing APIs (#223). (52380433)

0.1.0

Note: This release has breaking changes.

• BREAKING FEAT: Multi-modal and tenants support (#210). (bfb0d89c)

0.0.3

• DOCS: Fix invalid package topics. (f81b833a)
• DOCS: Add topics to pubspecs. (8c1d6297)

0.0.2

• REFACTOR: Update generated Chroma API client (#142). (4f0e7379)

0.0.1

• FEAT: Add Chroma embedding database API client (#140). (5fdcbc52)

0.0.1-dev.1

• Bootstrap package.