pinecone-io/python-sdk

Pinecone Python SDK – 快速概览

是什么：Pinecone 的托管向量数据库服务的 Python 客户端库。可让您创建索引、存储（upsert）嵌入向量的文档，并直接从 Python 代码中执行相似性搜索。

核心功能

• 索引管理 – 通过 pc.indexes.create 创建、配置和删除 Pinecone 索引。
• 文档导向 API – 将每个记录视为一个 JSON 文档，包含 _id、密集向量字段，以及您在模式中定义的任何自定义元数据。
• 相似性搜索 – 使用 DenseVectorQuery 查询，通过余弦相似度或其他度量方式检索最相似的项目（top-k）。
• 异步支持 – AsyncPinecone 客户端支持 asyncio，适用于非阻塞工作负载。
• 配置 – 支持便捷的 API 密钥处理、自定义主机、超时设置和调试日志。

典型工作流

1. 使用 API 密钥初始化客户端。
2. 指定包含 dense_vector 字段的模式来创建索引。
3. 将文档（向量 + 元数据）upsert 到命名空间中。
4. 使用密集向量查询进行搜索，获取匹配的文档 ID 和得分。

为何重要：向量数据库是现代 AI 流水线的核心组件——用于存储 LLM、图像模型等生成的嵌入向量，并支持推荐、语义搜索和 RAG（检索增强生成）等场景下的快速最近邻检索。

快速开始

pip install pinecone

from pinecone import Pinecone, DenseVectorQuery
pc = Pinecone(api_key="YOUR_KEY")
# 如 README 所示创建、upsert、搜索……

开发：使用 uv 进行依赖管理，内置测试、类型检查（mypy）、代码格式化（ruff）和格式化。集成测试会调用实时服务，需要 API 密钥。

许可证：Apache-2.0。

---

所有细节均直接取自仓库的 README。