python-sdk

用 Python 轻松操作 Pinecone 向量库,快速实现向量检索

开源 🏷️定价信息待确认 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 140 🐛 待处理 65 👀 关注 24
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 456
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

python-sdk 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队pinecone-io
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型pinecone,python,rag,sdk,vector-database,vector-search
GitHub 星标★ 456
上线时间2021-09-16 00:00:00
代码更新2026-11-03
仓库体积21.9 MB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-08-09
浏览次数5

项目介绍

Pinecone 官方 Python SDK,用于连接和操作 Pinecone 向量数据库。它解决了开发者在使用 Pinecone 时缺乏官方 Python 客户端的问题,提供了简洁的 API 来创建、管理和查询向量索引。核心能力包括:索引的创建与删除、向量的 upsert、查询、更新、删除,以及元数据过滤和命名空间管理。SDK 封装了底层 REST API,支持同步和异步操作,并提供了类型提示,方便在 Python 项目中集成向量检索功能。适用于构建语义搜索、推荐系统、异常检测等需要向量相似性搜索的应用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 456

使用教程

难度:入门 约 12 分钟 部署方式:本地安装 4 步

环境要求

  • Python 3.8+
  • Pinecone 账号与 API Key

安装与启动步骤

  1. 1装 SDK

    官方包名就是 pinecone,装完即可用。

    pip install pinecone
  2. 2拿到 API Key

    在控制台建一个项目再取 key,别用账号级 key。

  3. 3建一个索引

    先建小维度的索引试通,维度必须和你的向量模型一致。

  4. 4写入并查询

    upsert 几条记录后立刻 query,确认维度与度量方式没错。

如何确认成功

能 upsert 三条记录并 query 回其中一条的 id,返回的 score 在 0 到 1 之间且排序符合预期

注意事项

  • 它是托管的向量库客户端,装完仍需联网,不能离线跑。
  • 索引维度和距离度量建好就改不了,动手前先定死用哪个嵌入模型。
  • 免费档有索引数与向量数上限,压测前先看配额页面。
  • 批量 upsert 要注意单次条数上限,超了会被拆包但延迟变高。
  • 删索引用代码调用时不可逆,脚本里加二次确认。

核心亮点

  • 官方出品,API 设计与服务同步,兼容性好
  • 支持同步和异步客户端,灵活适应不同场景
  • 提供完整的 CRUD 和查询操作,覆盖向量数据库核心需求

不足之处

  • 仅针对 Pinecone 服务,无法用于其他向量数据库
  • 文档和社区资源相对较少,处于早期阶段

适用场景

  • 构建语义搜索应用,快速接入向量检索能力
  • 开发推荐系统,利用向量相似度匹配用户偏好
  • 实现异常检测,通过向量距离识别离群点

替代项目

Qdrant Python Client、Weaviate Python Client、Milvus Python SDK

上一篇:smfs

下一篇:qvac

同类项目推荐

k8ssandra-operator 开源

在 K8s 上像管理应用一样管理 Cassandra 集群,自动部署与运维

The Kubernetes operator for K8ssandra

★ 243 2026-08-09
llm-graph-builder 开源

上传文档,一键用LLM自动生成知识图谱

Neo4j graph construction from unstructured data using LLMs

★ 5301 2026-08-09
bex 开源

Git push 即部署,让 AI 智能体成为你的运维搭档。

The open-source Render alternative — AI-native. Git push → build → deploy on your···

★ 576 2026-08-09
tokenspeed 开源

让大模型在现有硬件上跑出光速级 token 生成速度

TokenSpeed is a speed-of-light LLM inference engine.

★ 2889 2026-08-09
prompt-cache 开源

给 LLM 加个缓存,成本直降 80%,响应快到飞起

Cut LLM costs by up to 80% and unlock sub-millisecond responses with intelligent sem···

★ 426 2026-08-09
subnet-2 开源

给去中心化 AI 推理加上可验证证明

Verifiable inference on Bittensor

★ 2463 2026-11-08
CPA_Orbit 开源

本地命令行统一管理 AI 账号与配额,实时监控价格

From K12 price radar to CPA proxy operations: a local-first console for offers, subs···

★ 68 2026-08-09
foxglove-sdk 开源

多语言记录机器人数据,一键回放可视化

Log and visualize multimodal data for robotics and physical AI

★ 320 2026-11-01
ai-inference 开源

在 GitHub 流水线里一键调用 AI 模型

An action for calling AI models with GitHub Models

★ 526 2026-10-25