v3.4.0

NVIDIA/NeMo-Retrieverv3.4.0Sep 28, 2026by github-actions[bot]

Upgrading?

AI Summary

This release focuses on performance optimizations for vector search and database traversal, alongside significant improvements to the CLI and documentation. It includes stability fixes for edge handling, datetime conversions, and SDK error handling.

Key Highlights

  • Performance improvements for vector search, including overlap row reads and bounded traversal-scoped searches.
  • New CLI features: ID-free Cloud commands, consistent output formatting, and a global --json flag.
  • Opt-in local disk cache support via HELIX_DISK_CACHE_DIR.
  • Major documentation overhaul with a new 'Learn' tab and restructured navigation.
  • Stability fixes for edge-stream drops, datetime parsing, and SDK error handling.

New Features

  • Opt-in local disk cache via HELIX_DISK_CACHE_DIR
  • ID-free Cloud commands in CLI
  • Global --json flag in CLI
  • TypeScript SDK 3.1.0 with structured transaction errors
  • New 'Learn' tab in documentation

Full Release Notes

## What's Changed
* Restore production coverage for unique equality batches by @xav-db in https://github.com/HelixDB/helix-db/pull/1119
* Skip unchanged vector-cache hydration by @xav-db in https://github.com/HelixDB/helix-db/pull/1115
* Fix edge-stream drop silently leaving edges undeleted by @xav-db in https://github.com/HelixDB/helix-db/pull/1114
* Fix edge-drop stack overflow and test inventory by @xav-db in https://github.com/HelixDB/helix-db/pull/1120
* fix(db): key DISTINCT on storage value identity, not Debug strings by @nkootstra in https://github.com/HelixDB/helix-db/pull/1110
* Release TypeScript SDK 3.1.0 with structured transaction errors by @matthewsanetra in https://github.com/HelixDB/helix-db/pull/1102
* Stop eligible query pipelines when downstream limits are satisfied by @xav-db in https://github.com/HelixDB/helix-db/pull/1112
* fix(ts-sdk): map out-of-range datetimes to QueryError by @danielgaskins in https://github.com/HelixDB/helix-db/pull/1122
* Fix permanent index cleanup failures and validation diagnostics by @xav-db in https://github.com/HelixDB/helix-db/pull/1078
* fix(planner): keep implementing queued expressions after the time budget expires by @nkootstra in https://github.com/HelixDB/helix-db/pull/1113
* fix(sdks): reject invalid byte values by @danielgaskins in https://github.com/HelixDB/helix-db/pull/1124
* fix(ci,cli): replace withdrawn MinIO images with SeaweedFS by @xav-db in https://github.com/HelixDB/helix-db/pull/1136
* perf(planner,db): answer post-expansion filters from index membership by @xav-db in https://github.com/HelixDB/helix-db/pull/1130
* perf(db): overlap vector row reads and serve the vector memory cache on readers and newer snapshots by @xav-db in https://github.com/HelixDB/helix-db/pull/1131
* perf(db): bounded, sound traversal-scoped vector search with exact scans for mid-size scopes by @xav-db in https://github.com/HelixDB/helix-db/pull/1137
* perf(db): retain the vector build planning cache across backfill steps by @xav-db in https://github.com/HelixDB/helix-db/pull/1132
* feat(server): opt-in local disk cache via HELIX_DISK_CACHE_DIR by @xav-db in https://github.com/HelixDB/helix-db/pull/1133
* test(db): scoped search benchmark harness, recall gate and coverage metadata by @xav-db in https://github.com/HelixDB/helix-db/pull/1138
* docs: restructure navigation, search guides, and CLI reference by @xav-db in https://github.com/HelixDB/helix-db/pull/1129
* docs: add a Learn tab with a learning center for search, graph, and memory topics by @xav-db in https://github.com/HelixDB/helix-db/pull/1139
* fix(python-sdk): convert datetimes to exact milliseconds by @breken-ai in https://github.com/HelixDB/helix-db/pull/1126
* fix(graph-algorithms): count parallel edges once in betweenness paths by @breken-ai in https://github.com/HelixDB/helix-db/pull/1127
* fix(python-sdk): render datetimes exactly and map out-of-range millis to QueryError by @breken-ai in https://github.com/HelixDB/helix-db/pull/1128
* feat(cli): ID-free Cloud commands, consistent cliclack output, and global --json by @xav-db in https://github.com/HelixDB/helix-db/pull/1140
* fix(planner): replace the wall-clock exploration budget with a rule-fire budget by @xav-db in https://github.com/HelixDB/helix-db/pull/1141
* docs: make the README faster to scan by @xav-db in https://github.com/HelixDB/helix-db/pull/1143
* docs: rewrite Learn pages for newcomers by @xav-db in https://github.com/HelixDB/helix-db/pull/1142
* fix(planner): price index membership by what the interpreter reads by @xav-db in https://github.com/HelixDB/helix-db/pull/1145
* fix(planner): retain equality index seeds with residual filters by @xav-db in https://github.com/HelixDB/helix-db/pull/1125
* Release CLI 3.4.0 and Docker v0.0.7 by @xav-db in https://github.com/HelixDB/helix-db/pull/1146

## New Contributors
* @danielgaskins made their first contribution in https://github.com/HelixDB/helix-db/pull/1122
* @breken-ai made their first contribution in https://github.com/HelixDB/helix-db/pull/1126

**Full Changelog**: https://github.com/HelixDB/helix-db/compare/v3.3.0...v3.4.0

Related Repositories