English | 中文

zvec logo

Code Coverage Main License PyPI Release Python Versions npm Release

alibaba%2Fzvec | Trendshift

🚀 Quickstart | 🏠 Home | 📚 Docs | 📊 Benchmarks | 🔎 DeepWiki | 🎮 Discord | 🐦 X (Twitter)

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.

[!Important] 🚀 v0.5.0 (June 12, 2026)

  • Full-Text Search (FTS): Native full-text search — attach an FTS index to any string field and query it with natural-language or structured expressions, no external search engine required.
  • Hybrid Retrieval: Combine full-text, dense-vector, and sparse-vector retrieval in a single query call, with scalar filtering and reranking.
  • DiskANN Index: New on-disk index that keeps the bulk of the index on disk, drastically cutting memory usage for large-scale datasets.
  • Ecosystem & Platforms: New official Go / Rust SDKs, the Zvec Studio visual tool, and RISC-V support.

👉 Read the Release Notes | View Roadmap 📍

💫 Features

  • Blazing Fast: Searches billions of vectors in milliseconds.
  • Simple, Just Works: Install and start searching in seconds. Pure local, no servers, no config, no fuss.
  • Dense + Sparse Vectors: Support dense and sparse embeddings, multi-vector queries, and a rich selection of vector index types that scale from memory to disk.
  • Full-Text Search (FTS): Native keyword-based full-text search — query string fields with natural-language or structured expressions.
  • Hybrid Search: Fuse vector similarity, full-text search, and structured filters in a single query for precise results.
  • Durable Storage: Write-ahead logging (WAL) guarantees persistence — data is never lost, even on process crash or power failure.
  • Concurrent Access: Multiple processes can read the same collection simultaneously; writes are single-process exclusive.
  • Runs Anywhere: As an in-process library, Zvec runs wherever your code runs — notebooks, servers, CLI tools, or even edge devices.

📦 Installation

Zvec offers official SDKs across multiple languages:

  • Python: pip install zvec (requires 64-bit Python 3.10–3.14)
  • Node.js: npm install @zvec/zvec
  • Go: High-performance Go bindings.
  • Rust: High-performance Rust bindings.
  • Dart/Flutter: flutter pub add zvec

Prefer a visual tool? Try Zvec Studio to browse data and debug queries — no code required.

✅ Supported Platforms

  • Linux (x86_64, ARM64)
  • macOS (ARM64)
  • Windows (x86_64)

🛠️ Building from Source

If you prefer to build Zvec from source, please check the Building from Source guide.

⚡ One-Minute Example

import zvec

# Define collection schema
schema = zvec.CollectionSchema(
    name="example",
    vectors=zvec.VectorSchema("embedding", zvec.DataType.VECTOR_FP32, 4),
)

# Create collection
collection = zvec.create_and_open(path="./zvec_example", schema=schema)

# Insert documents
collection.insert([
    zvec.Doc(id="doc_1", vectors={"embedding": [0.1, 0.2, 0.3, 0.4]}),
    zvec.Doc(id="doc_2", vectors={"embedding": [0.2, 0.3, 0.4, 0.1]}),
])

# Search by vector similarity
results = collection.query(
    zvec.Query(field_name="embedding", vector=[0.4, 0.3, 0.3, 0.1]),
    topk=10
)

# Results: list of {'id': str, 'score': float, ...}, sorted by relevance
print(results)

📈 Performance at Scale

Zvec delivers exceptional speed and efficiency, making it ideal for demanding production workloads.

Zvec Performance Benchmarks

For detailed benchmark methodology, configurations, and complete results, please see our Benchmarks documentation.

🤝 Join Our Community

💬 DingTalk 📱 WeChat 🎮 Discord X (Twitter)
DingTalk QR Code WeChat QR Code Discord X (formerly Twitter) Follow
Scan to join Scan to join Click to join Click to follow

❤️ Contributing

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.

Check out our Contributing Guide to get started!

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for zvec from gravatar.com zvec

Credits

Author: zvec

Maintainer: Zvec Core Team

License

Apache Software License (Apache-2.0)

Requires

Python >=3.9

Provides Extra

test docs dev

Tags

vector-database ann nearest-neighbor

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

zvec-0.6.0-cp314-cp314-win_amd64.whl (13.5 MB view details)

Uploaded CPython 3.14Windows x86-64

zvec-0.6.0-cp314-cp314-manylinux_2_28_x86_64.whl (19.7 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.28+ x86-64

zvec-0.6.0-cp314-cp314-manylinux_2_28_aarch64.whl (17.4 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.28+ ARM64

zvec-0.6.0-cp314-cp314-macosx_11_0_arm64.whl (12.3 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

zvec-0.6.0-cp313-cp313-win_amd64.whl (13.0 MB view details)

Uploaded CPython 3.13Windows x86-64

zvec-0.6.0-cp313-cp313-manylinux_2_28_x86_64.whl (19.7 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ x86-64

zvec-0.6.0-cp313-cp313-manylinux_2_28_aarch64.whl (17.4 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ ARM64

zvec-0.6.0-cp313-cp313-macosx_11_0_arm64.whl (12.3 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

zvec-0.6.0-cp312-cp312-win_amd64.whl (13.0 MB view details)

Uploaded CPython 3.12Windows x86-64

zvec-0.6.0-cp312-cp312-manylinux_2_28_x86_64.whl (19.7 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ x86-64

zvec-0.6.0-cp312-cp312-manylinux_2_28_aarch64.whl (17.4 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ ARM64

zvec-0.6.0-cp312-cp312-macosx_11_0_arm64.whl (12.3 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

zvec-0.6.0-cp311-cp311-win_amd64.whl (13.0 MB view details)

Uploaded CPython 3.11Windows x86-64

zvec-0.6.0-cp311-cp311-manylinux_2_28_x86_64.whl (19.7 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ x86-64

zvec-0.6.0-cp311-cp311-manylinux_2_28_aarch64.whl (17.4 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ ARM64

zvec-0.6.0-cp311-cp311-macosx_11_0_arm64.whl (12.3 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

zvec-0.6.0-cp310-cp310-win_amd64.whl (12.9 MB view details)

Uploaded CPython 3.10Windows x86-64

zvec-0.6.0-cp310-cp310-manylinux_2_28_x86_64.whl (19.7 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.28+ x86-64

zvec-0.6.0-cp310-cp310-manylinux_2_28_aarch64.whl (17.4 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.28+ ARM64

zvec-0.6.0-cp310-cp310-macosx_11_0_arm64.whl (12.3 MB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

File details

Details for the file zvec-0.6.0-cp314-cp314-win_amd64.whl.

File metadata

  • Download URL: zvec-0.6.0-cp314-cp314-win_amd64.whl
  • Upload date:
  • Size: 13.5 MB
  • Tags: CPython 3.14, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for zvec-0.6.0-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 22f8a8cf320fdb9692c92b5e5dde6172e2f2ef028b2090876e0023c74d21ff68
MD5 8549095ea29fc95206a3115a85825b63
BLAKE2b-256 319e696c0c26cd56beb13b8cc93dc6f9c3b6fb97c00db0954d8d770e5db71df4

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp314-cp314-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp314-cp314-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 aa91e8bba7f965bc94d60a9fc96aaa2649352cc0c4286890d51a0c1dfbdc87c8
MD5 e4ce997a78994328f6cb685badddc11f
BLAKE2b-256 4f3fe09523c1e1a586e1b528f7f1fc03cc0db829885075c9da4d9005b8db8b81

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp314-cp314-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp314-cp314-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 e143cb949f9edcbb2c67d5120d43818daf45f1d4abbc8acec7a4e4c5dc5b4130
MD5 e5c8d95ba88b9af6cd3ee537f12104f6
BLAKE2b-256 780bd837fafb8bf38e7ce542d396fa213137c1167b643f5f87459b5ef5454875

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 44f00c863cdb622e7fb7944abbd81f6d114cedeb6f69a8516504b5358abf3cbe
MD5 224642ad7094f290d16494f4e8773ac2
BLAKE2b-256 9d04d961494ac46fc3041245f10f7f125b6ec5c109b85557a3ceb2a56d00c38e

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: zvec-0.6.0-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 13.0 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for zvec-0.6.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 ce301f66f1c10d6df91d234f189239fd5fe07a8157633e143d477a4934fc3992
MD5 acb2dba9afa71fec492a790e4ccd4cf8
BLAKE2b-256 cf909e9ad844685d15e5c9018094703ac8502e20d98b20c6902404a32ad6d47b

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp313-cp313-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp313-cp313-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8f3eda20ce95b560e0017619ecfeb8ef9f6d74ef844a3b003958cc0feea419f0
MD5 bac7b8d443797f14da253799f5ad8549
BLAKE2b-256 b36eac765097f921e021b109a708d915115cf7ca7097a81dad49b78a0cc174de

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp313-cp313-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp313-cp313-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 5defdf2c6748056af5e7b01c8857c92a3a0d7933316d1c99af83a768e493cdc9
MD5 ccded022d9bb11871905ca10d90e157d
BLAKE2b-256 3c926c3a2a07c09b2cb98ba96f9d14590f2d4c1b5ac93b3a7430d09f95fb997e

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 3d503bbce8275f3efed935c42d67eb771c4b8c277140e934193f56a527597391
MD5 5967b1e962b86b7b7b5fb9706d73e7eb
BLAKE2b-256 ba2dccfa996c829d95f1b4e3465a58fb95bf25b7c6045533a06896573632b9ff

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: zvec-0.6.0-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 13.0 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for zvec-0.6.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 b846cdbeca48112961f91a7f7971ca6014ff8892b465af8a787700a1b3a0f585
MD5 239015d92851c1d35b6859872df6313e
BLAKE2b-256 ce2e4f4e25f1e647d4d91c5e5a44674d388869c10a90a5de6c40cbd23fd3fabf

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp312-cp312-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp312-cp312-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 75676b77bf1e280a1822f9911203b5892fcb055b2ff4a0a50fd25ce0334892ce
MD5 39a2179be3fd21af8180ffa0d74445b2
BLAKE2b-256 ff3ec31c139867d920fd23af4e374e7fc3dcbed6954ef861a9bd66ac9d040254

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp312-cp312-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp312-cp312-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 394c568ead1f881ea78b6ee3e8fafdaaa242d34b527449c4a928997c51b78363
MD5 f9a9194c71522002dcdac7a40aef0623
BLAKE2b-256 6c7421124c3b2ee214132118a53d438b95df1ccd9b0f0faf04df71caa6feec5f

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7444b90e0351bbfaefcae601ee5d148926996ce6b67049f31b18f81bc2a27f33
MD5 5582e85a5f7b1b3521bc677740890261
BLAKE2b-256 0adb67ce3e9cad1ad1d23dbc57880b3148a0cee0c3df66050eda9dd2d29cdc27

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: zvec-0.6.0-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 13.0 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for zvec-0.6.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 2d168fb8a15f2c6b37a3e9e8f818bab14317f42c5cab33edd628c3ebf8381f34
MD5 92c23b545abbdab3fe52a9479dfec3f0
BLAKE2b-256 ae0ba91063ea0d6024d81bbfc0f8269bde3158e465baa2603839d2482688a7dd

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp311-cp311-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 474de64920fb9d02817e6995f03937a4f3ec3594a0960b4d90624863bf2f3095
MD5 5dbd08b730a0c6e23c97a540684fff49
BLAKE2b-256 fa1bd7bea9e9cd9f82947a26b7274539922ca66824d844161d69b57225d78e6e

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp311-cp311-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp311-cp311-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 60e9ba18b97ef2ffaaebbd233e1a91e5bb013ff4a73f54a6ca28dda7f3e4e9e8
MD5 341ba9ba0b280279d64581271ceca7c2
BLAKE2b-256 d85f5f3a93461bb18c561913e3cdc4681c650bd05623be2c46522f4ca9429af8

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4f0f4d2dbc2552d237c6209b09cc023914b70fc746fae1458511aedd34813383
MD5 b9a36d8dcad658a678332bbc2d8302f6
BLAKE2b-256 51a31f46239b5b8c1863ae83592d0b62a831f8a8915491d0277c2231cd6a0933

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: zvec-0.6.0-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 12.9 MB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for zvec-0.6.0-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 72f3080411b6bb75d030bfcbba72dd6b8d00910eb37a49518e66e161e13ec3fd
MD5 88bff7337dd3f8515f283b278fd0852c
BLAKE2b-256 071ff843554c669c6029f06538b00d9444ab254592c6e31f353369a2f73d0415

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp310-cp310-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp310-cp310-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 cd96ea6720ff156756fe13f2398bed3b75577505fabbb25dfdc2b016c44ef4a0
MD5 56ac71e2a500189c89c3138ff561932d
BLAKE2b-256 9680edb432349b6da09faba15335539344e650b93809d4e520743e5c97163894

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp310-cp310-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp310-cp310-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 5cc4eb12a1665fd0726b9f4e4db9b712ff0fc3e34dc6a745e5143cb2b338096f
MD5 7442212dd1e6b30b7a8eaebe864a444d
BLAKE2b-256 2f3ac160650dc876743e05826cb36471e12b5d522f92952b96e595f119fd1cdc

See more details on using hashes here.

File details

Details for the file zvec-0.6.0-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zvec-0.6.0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c9040d309e5e29b5ce442238215b5d5668075afbf6f6128b8b4a8518f0d325d2
MD5 14ea7013655552b91814bc4850e7cf1a
BLAKE2b-256 7fdf3be46b99573b8fbc232e2ce2c86a6e76155727f65f3a378251a31b930f07

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page