Pinecone Python SDK

!License   

The official Pinecone Python SDK for building vector search applications with AI/ML.

Pinecone is a vector database that makes it easy to add vector search to production applications. Use Pinecone to store, search, and manage high-dimensional vectors for applications like semantic search, recommendation systems, and RAG (Retrieval-Augmented Generation).

Features

Vector Operations: Store, query, and manage high-dimensional vectors with metadata filtering

Serverless & Pod Indexes: Choose between serverless (auto-scaling) or pod-based (dedicated) indexes

Integrated Inference: Built-in embedding and reranking models for end-to-end search workflows

Async Support: Full asyncio support with PineconeAsyncio for modern Python applications

GRPC Support: Optional GRPC transport for improved performance

Type Safety: Full type hints and type checking support

Table of Contents

Documentation

Prerequisites

Installation

Quickstart

- Bringing your own vectors
- Bring your own data using Pinecone integrated inference

Pinecone Assistant

More Information

Issues & Bugs

Contributing

Documentation

Conceptual docs and guides

Python Reference Documentation

Upgrading the SDK

> [!NOTE]
> The official SDK package was renamed from pinecone-client to pinecone beginning in version 5.1.0.
> Please remove pinecone-client from your project dependencies and add pinecone instead to get
> the latest updates.

For notes on changes between major versions, see Upgrading

Prerequisites

The Pinecone Python SDK requires Python 3.10 or greater. It has been tested with CPython versions from 3.10 to 3.13.

Before you can use the Pinecone SDK, you must sign up for an account and find your API key in the Pinecone console dashboard at https://app.pinecone.io.

Installation

The Pinecone Python SDK is distributed on PyPI using the package name pinecone. The base installation includes everything you need to get started with vector operations, but you can install optional extras to unlock additional functiona

... [truncated — view full README on GitHub]