# chroma-go

> The Go client for Chroma vector database

- **URL**: https://www.freshcrate.ai/projects/chroma-go
- **Author**: amikos-tech
- **Category**: Databases
- **Latest version**: `v0.4.1` (2026-04-08)
- **License**: MIT
- **Source**: https://github.com/amikos-tech/chroma-go
- **Homepage**: https://go-client.chromadb.dev
- **Language**: Go
- **GitHub**: 202 stars, 34 forks
- **Registry**: github
- **Tags**: `chromadb`, `client`, `embeddings`, `go`, `vector-database`

## Description

The Go client for Chroma vector database

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.4.1` | 2026-04-08 | High | ## What's Changed * Gemini EF: add task_type/dimension support with schema persistence by @tazarov in https://github.com/amikos-tech/chroma-go/pull/441 * docs: add GSD codebase map scaffold by @tazarov in https://github.com/amikos-tech/chroma-go/pull/444 * chore(deps): bump google.golang.org/grpc from 1.68.1 to 1.79.3 in the go_modules group across 1 directory by @dependabot[bot] in https://github.com/amikos-tech/chroma-go/pull/445 * ci: skip cloud jobs for external PRs by @tazarov in https: |
| `v0.4.0` | 2026-03-05 | Low | ## What's Changed * docs(readme): mark Modify Collection as supported by @tazarov in https://github.com/amikos-tech/chroma-go/pull/395 * docs: add sitewide EthicalAds integration by @tazarov in https://github.com/amikos-tech/chroma-go/pull/396 * Bump CI to Chroma 1.5.1 and align schema FTS/SPANN behavior by @tazarov in https://github.com/amikos-tech/chroma-go/pull/398 * feat(v2): add embedded local client with downloader and cross-runtime tests by @tazarov in https://github.com/amikos-tech/c |
| `v0.3.5` | 2026-02-17 | Low | ## What's Changed * feat(metadata): add array metadata support with contains operators by @tazarov in https://github.com/amikos-tech/chroma-go/pull/387 * feat(metadata): support Go integer types in []interface{} array conversion by @tazarov in https://github.com/amikos-tech/chroma-go/pull/390 * v2: document NewMetadataFromMap compatibility behavior and add strict map conversion by @tazarov in https://github.com/amikos-tech/chroma-go/pull/391 * fix(docs): add WithInclude to README query examp |
| `v0.3.4` | 2026-02-09 | Low | ## What's Changed * fix(query): correct Documents grouping in multi-query QueryResult deserialization by @tazarov in https://github.com/amikos-tech/chroma-go/pull/384 * chore(ci): bump Chroma version to 1.5.0 by @tazarov in https://github.com/amikos-tech/chroma-go/pull/385   **Full Changelog**: https://github.com/amikos-tech/chroma-go/compare/v0.3.3...v0.3.4 |
| `v0.3.3` | 2026-02-06 | Low | ## What's Changed * fix(v2): correct Satisfies off-by-one error and use Embedding interface for base64 encoding by @tazarov in https://github.com/amikos-tech/chroma-go/pull/360 * fix(v2): backport improvements from official Chroma Go client by @tazarov in https://github.com/amikos-tech/chroma-go/pull/361 * refactor(v2): replace deprecated WithDebug with slog-based WithLogger in tests by @tazarov in https://github.com/amikos-tech/chroma-go/pull/363 * fix(v2): add timeout to cloud test cleanup |
| `v0.3.2` | 2026-01-24 | Low | ## What's Changed * Fix nightly workflow to use correct make target by @Copilot in https://github.com/amikos-tech/chroma-go/pull/354 * feat(v2): add unified options API for collection operations by @tazarov in https://github.com/amikos-tech/chroma-go/pull/357 * feat(embeddings): add late chunking support to Jina embedding function by @tazarov in https://github.com/amikos-tech/chroma-go/pull/358  ## New Contributors * @Copilot made their first contribution in https://github.com/amikos-tech/ |
| `v0.3.1` | 2026-01-20 | Low | ## What's Changed * [DOC] Add Go code examples documentation by @tazarov in https://github.com/amikos-tech/chroma-go/pull/347 * feat(v2): add IndexingStatus method to Collection interface by @tazarov in https://github.com/amikos-tech/chroma-go/pull/350 * feat(v2): add ReadLevel option to Search method by @tazarov in https://github.com/amikos-tech/chroma-go/pull/351 * docs: add IndexingStatus documentation for cloud features by @tazarov in https://github.com/amikos-tech/chroma-go/pull/352 |
| `v0.3.0` | 2026-01-17 | Low | ## What's Changed * [ENH] Logger for V2 API (#251) by @tazarov in https://github.com/amikos-tech/chroma-go/pull/259 * docs: add security considerations for debug logging by @tazarov in https://github.com/amikos-tech/chroma-go/pull/261 * [CHORE] Bump tests to use chroma v1.1.0 by @tazarov in https://github.com/amikos-tech/chroma-go/pull/262 * feat: add support for slog logging library by @tazarov in https://github.com/amikos-tech/chroma-go/pull/264 * [DOC] Add V1 API deprecation notice for v |
| `v0.3.0-alpha.4` | 2026-01-15 | Low | ## What's Changed * test(embeddings): add cross-language EF persistence tests by @tazarov in https://github.com/amikos-tech/chroma-go/pull/333 * feat(v2): add IDIn and IDNotIn filters for Search API by @tazarov in https://github.com/amikos-tech/chroma-go/pull/342 * feat(v2): add K() function for semantic field key marking in filters by @tazarov in https://github.com/amikos-tech/chroma-go/pull/344 * feat(v2): add Rows() and At() methods for ergonomic result iteration by @tazarov in https://gi |
| `v0.3.0-alpha.3` | 2026-01-13 | Low | ## What's Changed * fix(rerankings): update Jina default model to v2 by @tazarov in https://github.com/amikos-tech/chroma-go/pull/325 * feat(embeddings): auto-wire embedding function from collection configuration by @tazarov in https://github.com/amikos-tech/chroma-go/pull/326 * feat(embeddings): add HTTPS validation for embedding providers by @tazarov in https://github.com/amikos-tech/chroma-go/pull/327 * feat(embeddings): auto-wire sparse embedding function from collection schema by @tazar |

## Dependency audit

- **Score**: 28/100
- **Total deps**: 26
- **Resolved**: 0
- **Unresolved**: 26
- **License conflicts**: 0
- **Warnings**: 26
- **Scanned**: 2026-06-01

## Citation

- HTML: https://www.freshcrate.ai/projects/chroma-go
- Markdown: https://www.freshcrate.ai/projects/chroma-go.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/chroma-go/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._