zvec README

The project's README from github.com/alibaba/zvec. As one markdown file: README.md.

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.7.0 (August 24, 2026)

  • zvec-grep (zg): Local-first workspace search that unifies ripgrep, BM25, and vector search behind one CLI — built for humans and AI agents.
  • ReMe integration: zvec is now a file store backend in ReMe, the memory management kit for agents, providing in-process HNSW ANN search.
  • DiskANN productionization: Adds Linux ARM64 / macOS ARM64 support and an io_uring async I/O backend, with automatic fallback to the best available I/O option — no user intervention needed.
  • Index optimization: New IVF-RaBitQ index and PQ-INT8 quantizer; RaBitQ supports runtime AVX2 / AVX512 dispatch, so the same binary automatically picks the best path on each CPU.
  • Deployment experience improved: Prebuilt dynamic libraries slimmed significantly (macOS arm64 C API library 37→22 MB, -40%); new musl libc / Alpine Linux support; prebuilt SDK binaries for Linux (glibc/musl), macOS, Windows, Android, and iOS published with every release.
  • DocIterator: New iterator for streaming full-collection document traversal across C++, C, and Python.
  • Full-text search: New N-gram tokenizer, better suited for phrase, code, and short-text search.

👉 Read the Release Notes | View Roadmap 📍

💫 Features

📦 Installation

Zvec offers official SDKs across multiple languages:

Searching code or documents? Try 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 to browse data and debug queries — no code required.

✅ Supported Platforms

🛠️ 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!

zvec (alibaba/zvec)

Searching Database…

16.1K ·GitHub
Что это такое?Векторная база данных с открытым исходным кодом от Alibaba, работающая внутри вашего процесса, — лёгкий и очень быстрый движок поиска по сходству, который встраивается прямо в приложение. Проверена в реальной эксплуатации внутри Alibaba Group.
Так это отдельный сервер, который нужно разворачивать, или часть моего приложения?Это библиотека, а не сервер: она работает внутри вашего процесса, полностью локально и без настройки, везде, где выполняется ваш код, — в ноутбуках, на серверах, в утилитах командной строки и даже на устройствах на границе сети.
Как добавить её в проект?Установите официальный SDK: pip install zvec (64-битный Python 3.10-3.14), npm install @zvec/zvec, cargo add zvec-rust, биндинги для Go или flutter pub add zvec. Кроме того, Zvec Studio позволяет просматривать данные и отлаживать запросы без кода.
Нужно ли сначала установить что-то ещё?Только среду выполнения для выбранного SDK — например, 64-битный Python 3.10-3.14 для пакета из pip. Отдельный сервер базы данных, сервис или файлы конфигурации не нужны.
Могут ли несколько моих сервисов одновременно писать в одну коллекцию?Нет — запись доступна только одному процессу: читать коллекцию могут много процессов одновременно, а писать — только один. Целостность данных при этом не страдает: WAL гарантирует сохранение данных после сбоев и отключений питания.
На каких платформах она работает?Linux (x86_64 и ARM64, glibc и musl/Alpine), macOS (ARM64 и x86_64) и Windows (x86_64); готовые SDK-бинарники для Android и iOS выходят с каждым релизом.
Мои данные куда-то отправляются с моего компьютера?С вашего компьютера ничего не уходит. Zvec работает полностью локально и без серверов — вся индексация и поиск происходят внутри вашего собственного процесса.
Какие виды поиска она реально поддерживает?Плотные и разреженные эмбеддинги с мультивекторными запросами, полнотекстовый поиск по ключевым словам «из коробки», а также гибридный поиск, который объединяет векторное сходство, полнотекстовый поиск и структурированные фильтры в одном запросе. Типы векторных индексов масштабируются от хранения в памяти до хранения на диске.
Насколько она быстрая и какой объём данных выдерживает?Она ищет по миллиардам векторов за миллисекунды. В версии v0.7.0 DiskANN переведён в производственную готовность: добавлена поддержка Linux и macOS на ARM64, а также асинхронный бэкенд ввода-вывода iouring, который автоматически переключается на лучший доступный вариант.
Что такое zvec-grep (zg)?Это локальный инструмент поиска по рабочим проектам в командной строке, который объединяет ripgrep, поиск по BM25 и векторный поиск в одной команде; он рассчитан и на людей, и на ИИ-агентов. Кроме того, Zvec служит файловым хранилищем для ReMe — набора для управления памятью агентов.
What are similar projects?xerj, weaviate, memvid, RuVector, lancedb, qdrant, turbovec, milvus
Creator
alibaba
Size
10.8 MB
Stars
16.1K
Age
10mo
Commits · 90 Days