diff --git a/README.md b/README.md index 62c9161..47f348c 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,7 @@ +
+ English | 简体中文 +
++ English | 简体中文 +
+ ++ 🚀 快速开始 | + 🏠 主页 | + 📚 文档 | + 📊 性能报告 | + 🔎 DeepWiki | + 🎮 Discord | + 🐦 X (Twitter) +
+ +**Zvec** 是一款开源的嵌入式(进程内)向量数据库 — 轻量、极速,可直接嵌入应用程序。以极简的配置提供生产级、低延迟、可扩展的向量检索能力。 + +> [!IMPORTANT] +> **🚀 v0.3.0 已于 2026 年 4 月 3 日发布** +> +> - **新平台支持**:支持 **Windows (MSVC)** 和 **Android**。发布了官方 Windows **Python** 和 **Node.js** 安装包。 +> - **性能优化**:集成 **RabitQ** 量化以及 **CPU 指令集自适应检测**,优化 SIMD 执行。 +> - **生态集成**:提供 **C-API** 用于多种编程语言绑定,以及 **[MCP](https://github.com/zvec-ai/zvec-mcp-server) / [Skill](https://github.com/zvec-ai/zvec-agent-skills)** 集成。 +> +> 👉 [查看发布说明](https://github.com/alibaba/zvec/releases/tag/v0.3.0) | [查看路线图 📍](https://github.com/alibaba/zvec/issues/309) + +## 💫 核心特性 + +- **极致性能**:毫秒级响应,轻松检索数十亿级向量。 +- **开箱即用**:[安装](#-安装)后即刻开始搜索,无需服务器、无需配置、零门槛。 +- **稠密 + 稀疏向量**:支持稠密向量和稀疏向量,提供多向量联合查询的原生支持。 +- **混合检索**:向量语义搜索 + 标量条件过滤,获得精确结果。 +- **进程内运行**:无需单独部署服务,纯进程内运行。Notebook、高性能服务器、CLI 工具、边缘设备 — 随处可用。 + +## 📦 安装 + +### [Python](https://pypi.org/project/zvec/) + +**环境要求**:Python 3.10 - 3.14 + +```bash +pip install zvec +``` + +### [Node.js](https://www.npmjs.com/package/@zvec/zvec) + +```bash +npm install @zvec/zvec +``` + +### ✅ 支持的平台 + +- Linux (x86_64, ARM64) +- macOS (ARM64) +- Windows (x86_64) + +### 🛠️ 源码构建 + +如需从源码构建 Zvec,请参考[源码构建指南](https://zvec.org/en/docs/build/)。 + +## ⚡ 一分钟上手 + +```python +import zvec + +# 定义 collection schema +schema = zvec.CollectionSchema( + name="example", + vectors=zvec.VectorSchema("embedding", zvec.DataType.VECTOR_FP32, 4), +) + +# 创建 collection +collection = zvec.create_and_open(path="./zvec_example", schema=schema) + +# 插入 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]}), +]) + +# 向量相似度检索 +results = collection.query( + zvec.VectorQuery("embedding", vector=[0.4, 0.3, 0.3, 0.1]), + topk=10 +) + +# 查询结果:按相关性排序的 {'id': str, 'score': float, ...} 列表 +print(results) +``` + +## 📈 极致性能 + +Zvec 提供极致的速度和效率,能够轻松应对高要求的生产环境负载。 + +
|
| [](https://discord.gg/rKddFBBu9z) | [](