开源向量数据库,同时存储对象与向量,将向量相似度检索与结构化过滤结合起来。
qdrant/qdrant-client
Qdrant 向量搜索引擎的官方 Python 客户端库,支持同步与异步调用。
- Star
- 1,373
- Fork
- 357
- 未关闭 Issue
- 223
- 最近提交
- 3小时前
这是什么?
qdrant-client 是 Qdrant 向量搜索引擎的官方 Python SDK,包含 Qdrant API 的类型定义,并同时提供基于 REST 和 gRPC 的同步与异步调用方式。库中还封装了批量上传集合等常用辅助方法。
客户端提供本地模式,无需启动服务即可使用相同的 API。传入 ":memory:" 或文件路径即可创建嵌入式数据库,适合原型开发、Notebook 实验和 CI 测试。需要扩展时,只需修改连接参数,即可指向运行中的 Qdrant 服务或 Qdrant Cloud 集群。
可选的 Inference API 支持通过 FastEmbed 在本地生成向量(可选 GPU 加速),也可调用 Qdrant Cloud 托管的模型远程生成向量,从而无需单独搭建嵌入流程,即可直接写入和查询文本或图像。
核心功能
- 01为所有 Qdrant API 方法提供类型提示
- 02同时支持 REST 与 gRPC 的同步和异步客户端
- 03无需服务端的内存或本地磁盘模式
- 04Inference API,可使用本地 FastEmbed 或 Qdrant Cloud 远程模型生成向量
- 05提供批量上传向量与数据点的辅助方法
适用场景
- 基于 Qdrant 构建语义搜索或检索增强生成(RAG)后端
- 在 CI 流水线中无需部署服务即可运行向量搜索测试
- 在 Jupyter 或 Colab 中快速验证基于向量的搜索原型
- 编写查询 Qdrant 集群的异步 Python 服务
快速上手
- 1
从 PyPI 安装 Python 客户端
pip install qdrant-client - 2
使用 Docker 在本地启动 Qdrant 服务器
docker run -p 6333:6333 qdrant/qdrant:latest - 3
在 Python 中使用 QdrantClient(url="http://localhost:6333") 连接服务器
使用前须知
- 部分功能(如远程推理)仅在付费的 Qdrant Cloud 套餐中可用。
- 要完整使用,需要 Docker 或单独部署 Qdrant 服务器。
标签
常见问题
- qdrant-client 是什么?
- Qdrant 向量搜索引擎的官方 Python 客户端库,支持同步与异步调用。 qdrant-client 是 Qdrant 向量搜索引擎的官方 Python SDK,包含 Qdrant API 的类型定义,并同时提供基于 REST 和 gRPC 的同步与异步调用方式。库中还封装了批量上传集合等常用辅助方法。
- qdrant-client 可以免费使用吗?用的什么许可证?
- qdrant-client 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
- qdrant-client 还在维护吗?
- 活跃维护中。qdrant-client 最近一次提交是在 2026年10月22日。
- qdrant-client 适合用来做什么?
- 基于 Qdrant 构建语义搜索或检索增强生成(RAG)后端 在 CI 流水线中无需部署服务即可运行向量搜索测试 在 Jupyter 或 Colab 中快速验证基于向量的搜索原型 编写查询 Qdrant 集群的异步 Python 服务
- qdrant-client 怎么安装和运行?
- 从 PyPI 安装 Python 客户端: pip install qdrant-client 使用 Docker 在本地启动 Qdrant 服务器: docker run -p 6333:6333 qdrant/qdrant:latest 在 Python 中使用 QdrantClient(url="http://localhost:6333") 连接服务器
- 在哪里获取 qdrant-client?
- 源代码和安装说明在 GitHub 上:https://github.com/qdrant/qdrant-client
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
Epsilla 是一个开源 C++ 向量数据库,用于嵌入向量相似度搜索,支持元数据过滤、混合检索和 LLM 集成。
开源的视觉检索增强生成(RAG)流程,将网页和 PDF 渲染为截图进行检索,保留表格与图表信息。
Qdrant 是用 Rust 编写的向量相似度搜索引擎和向量数据库,支持带条件过滤的语义搜索与推荐。
本地向量索引与 RAG 工具,通过按需重算向量将存储占用降低约 97%,可在笔记本上检索个人数据。
面向 AI 应用的开源数据基础设施,用于存储文档与向量并支持语义、混合及全文检索。