Skip to content
Back to search

zvec

A lightweight, lightning-fast, in-process vector database

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/alibaba/zvec with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/alibaba/zvec'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alibaba-zvec/badge.svg)](/listings/alibaba-zvec)

HTML

<a href="/listings/alibaba-zvec"><img src="/api/listings/alibaba-zvec/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Zvec offers official SDKs across multiple languages:

- **[Python](https://pypi.org/project/zvec/)**: `pip install zvec` (requires 64-bit Python 3.10–3.14) - **[Node.js](https://www.npmjs.com/package/@zvec/zvec)**: `npm install @zvec/zvec` - **[Go](https://github.com/zvec-ai/zvec-go)**: High-performance Go bindings. - **[Rust](https://crates.io/crates/zvec-rust)**: `cargo add zvec-rust` - **[Dart/Flutter](https://pub.dev/packages/zvec)**: `flutter pub add zvec`

Searching code or documents? Try **[zvec-grep](https://github.com/zvec-ai/zvec-grep)** (`zg`) — a local-first search CLI that unifies ripgrep, BM25, and vector search, built for humans and AI agents.

Prefer a visual tool? Try **[Zvec Studio](https://github.com/zvec-ai/zvec-studio)** to browse data and debug queries — no code required.

✅ Supported Platforms

- Linux (x86_64, ARM64; glibc & musl) - macOS (ARM64, x86_64) - Windows (x86_64)

🛠️ Building from Source

If you prefer to build Zvec from source, please check the [Building from Source](https://zvec.org/en/docs/db/build/) guide.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 148 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="right">
  2. English | <a href="./README_CN.md">中文</a>
  3. </p>
  4. <div align="center">
  5. <picture>
  6. <source media="(prefers-color-scheme: dark)" srcset="https://zvec.oss-cn-hongkong.aliyuncs.com/logo/github_log_2.svg" />
  7. <img src="https://zvec.oss-cn-hongkong.aliyuncs.com/logo/github_logo_1.svg" width="400" alt="zvec logo" />
  8. </picture>
  9. </div>
  10. <p align="center">
  11. <a href="https://codecov.io/github/alibaba/zvec"><img src="https://codecov.io/github/alibaba/zvec/graph/badge.svg?token=O81CT45B66" alt="Code Coverage"/></a>
  12. <a href="https://github.com/alibaba/zvec/actions/workflows/01-ci-pipeline.yml"><img src="https://github.com/alibaba/zvec/actions/workflows/01-ci-pipeline.yml/badge.svg?branch=main" alt="Main"/></a>
  13. <a href="https://github.com/alibaba/zvec/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License"/></a>
  14. <a href="https://github.com/alibaba/zvec/releases/latest"><img src="https://img.shields.io/github/v/release/alibaba/zvec?label=release" alt="Latest Release"/></a>
  15. </p>
  16. <p align="center">
  17. <a href="https://trendshift.io/repositories/20830" target="_blank"><img src="https://trendshift.io/api/badge/repositories/20830" alt="alibaba%2Fzvec | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
  18. </p>
  19. <p align="center">
  20. <a href="https://zvec.org/en/docs/db/quickstart/">🚀 <strong>Quickstart</strong> </a> |
  21. <a href="https://zvec.org/en/">🏠 <strong>Home</strong> </a> |
  22. <a href="https://zvec.org/en/docs/db/">📚 <strong>Docs</strong> </a> |
  23. <a href="https://zvec.org/en/docs/db/benchmarks/">📊 <strong>Benchmarks</strong> </a> |
  24. <a href="https://deepwiki.com/alibaba/zvec">🔎 <strong>DeepWiki</strong> </a> |
  25. <a href="https://discord.gg/rKddFBBu9z">🎮 <strong>Discord</strong> </a> |
  26. <a href="https://x.com/ZvecAI">🐦 <strong>X (Twitter)</strong> </a>
  27. </p>
  28. **Zvec** is an open-source, in-process vector database — lightweight, lightning-fast, and designed to embed directly into applications. Battle-tested within Alibaba Group, it delivers production-grade, low-latency and scalable similarity search with minimal setup.
  29. > [!Important]
  30. > 🚀 **v0.8.0**
  31. >
  32. > - **Broader platform support**: Added **Intel Mac** and **Windows ARM64** builds, wheels, and SDKs; extended **DiskANN to Windows, Android, and iOS**, and **RaBitQ to Windows x86_64**.
  33. > - **Chinese FTS ready to use**: Embedded the default **Jieba dictionary and HMM model**, so Chinese tokenization needs no separate dictionary files or path configuration.
  34. > - **Lower index build costs**: Reduced peak memory during **IVF / DiskANN** builds and merges, and accelerated **HNSW RaBitQ** construction through vector reuse and batched lookups. Build and nested training tasks now enforce configured thread limits more strictly.
  35. > - **Faster distance computation**: Extensively refactored quantizers and distance calculations to benefit multiple
  36. quantization types and metrics, with major improvements to **INT4 kernels** and **Linux ARM64** performance.
  37. > - **Faster search**: Added faster **Uniform quantizers** and optimized **Vamana** graph layout and prefetching. Uniform quantization avoids per-point score reconstruction, though a shared min/max range can increase quantization error and reduce recall.
  38. > - **Bug fixes and improvements**: Added more flexible **UTF-8 document IDs** up to 1,024 bytes; fixed concurrent reads during segment switches, index rebuilding with deleted rows, and correctness issues in **LIKE** and floating-point range filters.
  39. >
  40. > 👉 [Read the Release Notes](https://github.com/alibaba/zvec/releases/tag/v0.8.0)
  41. [^query-performance]: Measured on GIST 1M with L2 distance, INT8 quantization, and HNSW on a 16-core Linux ARM64 system.
  42. ## 💫 Features
  43. - **Blazing Fast**: Searches billions of vectors in milliseconds.
  44. - **Simple, Just Works**: [Install](#-installation) and start searching in seconds. Pure local, no servers, no config, no fuss.
  45. - **Dense + Sparse Vectors**: Support dense and sparse embeddings, multi-vector queries, and a rich selection of [vector index types](https://zvec.org/en/docs/db/concepts/vector-index/#vector-index-types) that scale from memory to disk.
  46. - **Full-Text Search (FTS)**: Native keyword-based full-text search — query string fields with natural-language or structured expressions.
  47. - **Hybrid Search**: Fuse vector similarity, full-text search, and structured filters in a single query for precise results.
  48. - **Durable Storage**: Write-ahead logging (WAL) guarantees persistence — data is never lost, even on process crash or power failure.
  49. - **Concurrent Access**: Multiple processes can read the same collection simultaneously; writes are single-process exclusive.
  50. - **Runs Anywhere**: As an in-process library, Zvec runs wherever your code runs — notebooks, servers, CLI tools, or even edge devices.
  51. ## 📦 Installation
  52. Zvec offers official SDKs across multiple languages:
  53. | SDK | Install / Dependency | Source |
  54. | --- | --- | --- |
  55. | [Python](https://pypi.org/project/zvec/) | `pip install zvec` | [Source](https://github.com/alibaba/zvec/tree/main/python/zvec) |
  56. | [Node.js](https://www.npmjs.com/package/@zvec/zvec) | `npm install @zvec/zvec` | [Source](https://github.com/zvec-ai/zvec-node) |
  57. | [Go](https://pkg.go.dev/github.com/zvec-ai/zvec-go) | [Installation guide](https://github.com/zvec-ai/zvec-go#installation) | [Source](https://github.com/zvec-ai/zvec-go) |
  58. | [Rust](https://crates.io/crates/zvec-rust) | `cargo add zvec-rust` | [Source](https://github.com/zvec-ai/zvec-rust) |
  59. | [Java](https://central.sonatype.com/artifact/org.zvec/zvec-java) | `org.zvec:zvec-java` (Maven) | [Source](https://github.com/zvec-ai/zvec-java) |
  60. | [Dart / Flutter](https://pub.dev/packages/zvec) | `flutter pub add zvec` | [Source](https://github.com/zvec-ai/zvec-dart) |
  61. Python requires 64-bit Python 3.10–3.14; Java requires Java 8+.
  62. Searching code or documents? Try **[zvec-grep](https://github.com/zvec-ai/zvec-grep)** (`zg`) — a local-first search CLI that unifies ripgrep, BM25, and vector search, built for humans and AI agents.
  63. Prefer a visual tool? Try **[Zvec Studio](https://github.com/zvec-ai/zvec-studio)** to browse data and debug queries — no code required.
  64. ### ✅ Cross-Platform Support
  65. **Linux · macOS · Windows · Android · iOS**
  66. Zvec supports all major platforms — from servers and desktops to mobile devices.<br>
  67. For more details, please see the [platform support documentation](https://zvec.org/en/docs/db/platforms/).
  68. ### 🛠️ Building from Source
  69. If you prefer to build Zvec from source, please check the [Building from Source](https://zvec.org/en/docs/db/build/) guide.
  70. ## ⚡ One-Minute Python Example
  71. ```python
  72. import zvec
  73. # Define collection schema
  74. schema = zvec.CollectionSchema(
  75. name="example",
  76. vectors=zvec.VectorSchema("embedding", zvec.DataType.VECTOR_FP32, 4),
  77. )
  78. # Create collection
  79. collection = zvec.create_and_open(path="./zvec_example", schema=schema)
  80. # Insert documents
  81. collection.insert([
  82. zvec.Doc(id="doc_1", vectors={"embedding": [0.1, 0.2, 0.3, 0.4]}),
  83. zvec.Doc(id="doc_2", vectors={"embedding": [0.2, 0.3, 0.4, 0.1]}),
  84. ])
  85. # Search by vector similarity
  86. results = collection.query(
  87. zvec.Query(field_name="embedding", vector=[0.4, 0.3, 0.3, 0.1]),
  88. topk=10
  89. )
  90. # Results: list of {'id': str, 'score': float, ...}, sorted by relevance
  91. print(results)
  92. ```
  93. ## 📈 Performance at Scale
  94. Zvec delivers exceptional speed and efficiency, making it ideal for demanding production workloads.
  95. <img src="https://zvec.oss-cn-hongkong.aliyuncs.com/qps_10M.svg" width="800" alt="Zvec Performance Benchmarks" />
  96. For detailed benchmark methodology, configurations, and complete results, please see our [Benchmarks documentation](https://zvec.org/en/docs/db/benchmarks/).
  97. ## 🤝 Join Our Community
  98. <div align="center">
  99. <div align="center">
  100. | 💬 DingTalk | 📱 WeChat | 🎮 Discord | X (Twitter) |
  101. | :---: | :---: | :---: | :---: |
  102. | <img src="https://zvec.oss-cn-hongkong.aliyuncs.com/qrcode/dingding.png" width="150" alt="DingTalk QR Code"/> | <img src="https://zvec.oss-cn-hongkong.aliyuncs.com/qrcode/wechat.png?v3" width="150" alt="WeChat QR Code"/> | [![Discord](https://img.shields.io/badge/Discord-Join%20Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/rKddFBBu9z) | [![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/ZvecAI)](<https://x.com/ZvecAI>) |
  103. | Scan to join | Scan to join | Click to join | Click to follow |
  104. </div>
  105. </div>
  106. ## ❤️ Contributing
  107. We welcome and appreciate contributions from the community! Whether you're fixing a bug, adding a feature, or improving documentation, your help makes Zvec better for everyone.
  108. Check out our [Contributing Guide](./CONTRIBUTING.md) to get started!

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.