v0.4.0

astral-sh/uvv0.4.0May 9, 2026by iaojnh

AI Summary

Zvec v0.4.0 introduces Flutter/Android/iOS support and fixes critical recall bugs.

Key Highlights

  • Published official Flutter package with FFI bindings
  • Added iOS build support and expanded topK limits
  • Fixed SQ8 quantizer recall degradation
  • Integrated clang-tidy into CI pipeline

New Features

  • Dart/Flutter SDK support
  • iOS platform support
  • Enlarged topK limit
  • Legacy HNSW builder/searcher cleanup

Full Release Notes

## šŸš€ Zvec v0.4.0 Release Notes

### šŸ“¦ New Features
* **Dart/Flutter SDK (Android & iOS)**: Published the official [zvec](https://pub.dev/packages/zvec) Flutter package, providing Dart/Flutter FFI bindings for Zvec. Supports Android (arm64-v8a) and iOS (arm64). Prebuilt native libraries are automatically downloaded at build time — no manual native compilation required for end users. ([Issue #192](https://github.com/alibaba/zvec/issues/192))
* **Enlarged topK Limit**: Relaxed the upper bound on topK results to support larger-scale recall scenarios. ([#348](https://github.com/alibaba/zvec/pull/348))
* **iOS Build Support**: Added support for building on iOS platforms, further expanding cross-platform coverage. ([#321](https://github.com/alibaba/zvec/pull/321))

### šŸž Bug Fixes
* **SQ8 Quantizer Recall Drop**: Fixed a recall degradation caused by incorrect handling of int8Ā rounding in SQ8 quantizer metadata. ([#329](https://github.com/alibaba/zvec/pull/329))
* **query_params Type Validation**: Added stricter type checking on user-supplied query parameters to prevent runtime errors from invalid inputs. ([#351](https://github.com/alibaba/zvec/pull/351))
* **Windows Path Handling**: FixedĀ MakePathĀ behavior at drive root on Windows; addedĀ GetLastErrorString()Ā helper for more accurate OS error messages. ([#337](https://github.com/alibaba/zvec/pull/337),Ā [#341](https://github.com/alibaba/zvec/pull/341))
* **Relaxed Collection Path Restriction**: Removed overly strict validation constraints on the collection storage path. ([#340](https://github.com/alibaba/zvec/pull/340))
* **Remove Redundant Python Index Type Validation**: Removed duplicated vector index type validation on the Python side inĀ create_index. ([#297](https://github.com/alibaba/zvec/pull/297))
* Sparse vector indices is now sorted before feeding to core vector index engine. (#382)
* Other minor bug fixes. ([#370](https://github.com/alibaba/zvec/pull/370))

### šŸ”§ RefactoringĀ & Cleanup
* **Remove Legacy HNSW Builder/Searcher**: Cleaned up the legacy HNSW builder/searcher, andĀ hnsw-rabitq builder/searcher. ([#356](https://github.com/alibaba/zvec/pull/356),Ā [#367](https://github.com/alibaba/zvec/pull/367))
* **Fix C Example CMakeĀ & C++ Dynamic Library Build**: Corrected the CMake configuration for C language examples and improved theĀ C++ shared library build scripts. ([#347](https://github.com/alibaba/zvec/pull/347))

### šŸ¤– CIĀ & Build Improvements
* Refactored Android CI, enhanced iOS CI stability, and fixed code coverage reporting. ([#330](https://github.com/alibaba/zvec/pull/330),Ā [#332](https://github.com/alibaba/zvec/pull/332),Ā [#331](https://github.com/alibaba/zvec/pull/331))
* **clang-tidy in CI**: Integrated clang-tidy static analysis into the CI pipeline for changedĀ C/C++ files, strengthening code quality enforcement. ([#116](https://github.com/alibaba/zvec/pull/116))

### šŸ‘‹ New Contributors
Thanks to all first-time contributors in this release:
* [@kgeg401](https://github.com/kgeg401) ([#116](https://github.com/alibaba/zvec/pull/116))
* [@JoeJRW](https://github.com/JoeJRW) ([#329](https://github.com/alibaba/zvec/pull/329))
* [@songqing](https://github.com/songqing) ([#297](https://github.com/alibaba/zvec/pull/297))

---

**Full Changelog**:Ā [v0.3.0...v0.4.0](https://github.com/alibaba/zvec/compare/v0.3.0...v0.4.0)