项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2189
技术标签
使用教程
环境要求
- 已安装 Docker 并能拉取镜像
- 本机安装 psql 命令行工具(PostgreSQL 客户端)
- 本机 5432 端口未被占用
安装与启动步骤
-
1启动 Docker 容器
用官方镜像启动带 pgvecto.rs 扩展的 Postgres,镜像标签为 pg17-v0.4.0,容器名 pgvecto-rs-demo。
docker run \ --name pgvecto-rs-demo \ -e POSTGRES_PASSWORD=mysecretpassword \ -p 5432:5432 \ -d ghcr.io/tensorchord/pgvecto-rs:pg17-v0.4.0 -
2连接数据库
默认用户名 postgres,默认密码 mysecretpassword,回车后按提示输入密码即可进入 psql。
psql -h localhost -p 5432 -U postgres -
3启用 vectors 扩展
在 psql 中执行两条 SQL,先删除已有同名扩展再创建,确保扩展被正确启用。
DROP EXTENSION IF EXISTS vectors; CREATE EXTENSION vectors; -
4创建向量表
vector(n) 表示 n 维向量,示例建 3 维向量列,n 必须在 1 到 65535 之间。
CREATE TABLE items ( id bigserial PRIMARY KEY, embedding vector(3) NOT NULL ); -
5插入向量数据
可直接用字符串字面量插入,也可用 real[] 数组转换后插入,两种写法都支持。
INSERT INTO items (embedding) VALUES ('[1,2,3]'), ('[4,5,6]'); -
6执行相似度查询
用 <-> 算欧氏距离排序取最相似的 5 条;另有 <#> 负点积、<=> 余弦距离两个运算符。
SELECT * FROM items ORDER BY embedding <-> '[3,2,1]' LIMIT 5;
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
POSTGRES_PASSWORD | 是 | 设置 Postgres 超级用户 postgres 的密码 | mysecretpassword |
POSTGRES_USER | 否 | 默认用户为 postgres,README 未给出其他取值 | postgres |
5432:5432 | 是 | 将容器 5432 端口映射到宿主机 5432 | 5432:5432 |
如何确认成功
psql 连接成功,且执行 CREATE EXTENSION vectors; 无报错,再运行向量查询能返回结果即表示部署成功。
常见问题
Q:为什么一定要进 psql 手动启用扩展?
A:镜像只预装了扩展文件,README 明确要求在数据库里执行 DROP EXTENSION IF EXISTS vectors; 再 CREATE EXTENSION vectors; 才能使用向量类型与运算符。
Q:vector(n) 的维度有什么限制?
A:README 说明 1 ≤ n ≤ 65535。直接用无参数的 vector 类型或维度与列定义不符时,将无法在该列上创建索引。
Q:连接时提示认证失败怎么办?
A:确认使用用户名 postgres 与启动容器时 -e POSTGRES_PASSWORD 指定的密码(示例为 mysecretpassword)。
Q:这个项目还推荐继续用吗?
A:README 顶部提示已有新实现 VectorChord,稳定性和性能更好,官方建议用户迁移,并提供了迁移指南链接。
注意事项
- README 提示项目已有后继实现 VectorChord,新项目建议评估迁移。
- vector 与标量条件可组合做混合过滤检索,适合语义搜索与推荐场景。
- 命令中的密码 mysecretpassword 仅为示例,生产环境请替换为强密码。
核心亮点
- 基于 Rust 实现,内存安全且性能卓越,查询延迟低
- 支持 HNSW 和 IVF 索引,可灵活应对不同数据规模
- 原生支持混合检索,向量与标量条件可组合过滤
不足之处
- 项目相对年轻,文档和社区生态有待完善
- 与成熟扩展如 pgvector 相比,生产环境验证案例较少
适用场景
- AI 应用中的语义搜索(如文档、图片、商品检索)
- 推荐系统需要实时向量相似度匹配
- 需要结合向量与结构化条件进行精确过滤的场景
替代项目
pgvector、Milvus、Qdrant
上一篇:kiro-gateway
下一篇:node-llama-cpp
同类项目推荐
casdoor
开源
为 AI Agent 和 MCP 提供一站式身份认证与授权网关
An open-source Agent-first Identity and Access Management (IAM) /LLM MCP & agent gat···
Deepseek-API
开源
把 DeepSeek 对话封装成 OpenAI 兼容接口,改个地址就能用
Reverse engineered Deepseek chat into an OpenAI compatible API. Access V4 and R1 mod···
llamacore
开源
本地跑 GGUF 模型,点点鼠标就能聊、转、训、编排
Full-featured desktop client for llama.cpp. Chat with local GGUF models, manage llam···
warden
开源
给 AI 代理装一道企业级安全闸门,访问可控可审计
The secure gateway connecting AI agents to enterprise systems.
IAGA-Sentinel
开源
给AI智能体装个哨兵,实时监控安全与行为
IAGA Sentinel sits next to your AI agents and answers the one question the agent its···
minimal-embodiment
开源
给大模型装上身体,实现感知-行动闭环
A minimal hardware-software architecture giving large language models a closed-loop ···
OSCAR
开源
KV Cache 压到 2-bit,长上下文推理显存大降
OSCAR: Offline Spectral Covariance-Aware Rotation for 2-bit KV Cache Quantization
ai-dial-core
开源
一套 API 统一接入多家大模型,业务代码不用改
The main component of AI DIAL, which provides unified API to different chat completi···
GPTCache
开源
给 LLM 加个语义缓存,重复问题秒回,省钱又提速
Semantic cache for LLMs. Fully integrated with LangChain and llama_index.
