Skip to content

ZVec.NET

ZVec.NET

Production .NET SDK for Alibaba ZVec — DI, typed ODM, async APIs, SafeHandles, full indexes/FTS, and mobile RIDs.

Beta — 1.0.0-beta.5+zvec.0.6.0. Native AOT compatible. APIs may still evolve. PackageId ZVec.NET on nuget.org (distinct from the unrelated NuGet package Zvec).

Why ZVec.NET?

Feature What it means
DI-first AddZVec() / AddZVecCollection<T>() for ASP.NET Core, MAUI, Blazor Server
Typed ODM POCOs via ZVec.NET.Mapping — schema From<T>(), expression filters
Sync + async Lowest-latency sync; ValueTask async for hosts
Pin-based vectors ReadOnlyMemory<float> on hot paths
Safe native lifecycle SafeZvecHandle; factory shutdown disposes tracked collections
Cross-platform natives Single NuGet with runtimes/{rid}/native/
Full DB coverage HNSW, Flat, IVF, RaBitQ, DiskANN, Vamana, Invert, FTS; hybrid search; RRF/Weighted rerankers

Start here

  1. Install
  2. Quick start
  3. DI hosts or typed ODM
  4. Examples — in-repo hosts + external demos/POCs
  5. Index concepts → Theory

Docs vs upstream

Content Where
.NET SDK usage, DI, RIDs, binding gaps This site
Runnable host demos Examples (samples/ in this repo)
Advanced demos / POCs ZVec.Net-DemosAndPOCs
Vector DB product docs, ANN theory, benchmarks zvec.org
AI Integration (embeddings, MCP, model rerankers) Out of scope for ZVec.NET