Installation

Prerequisites

  • Python 3.10 or newer. Python 3.10 through 3.14 are tested and published for.

  • A Pinecone account and an API key. See Authentication for where the SDK looks for it.

Install

pip install pinecone

Or with uv:

uv add pinecone

What the base install already includes

There are no user-facing extras. pip install pinecone gives you the whole SDK:

  • The synchronous Pinecone client and the asyncio AsyncPinecone client. Both are built on httpx, so neither needs a separate install — see Sync vs. async.

  • The gRPC data-plane client, reached with pc.index(name=..., grpc=True). It is a compiled extension module shipped inside the wheel rather than a Python dependency, so there is nothing extra to install — see Using gRPC.

  • The Admin client for organization and project administration.

The dev and docs extras exist for working on the SDK itself, not for using it.

Wheels are published for Linux (glibc and musl, x86-64 and arm64), macOS (Intel and Apple silicon), and Windows x86-64. Installing from the source distribution instead builds the gRPC extension from Rust and needs a Rust toolchain.

pandas is not installed for you

One method, upsert_from_dataframe(), takes a pandas.DataFrame. pandas is deliberately not a dependency of this SDK and not offered as an extra, because that one method is the only thing that wants it. Install it yourself if you use it:

pip install pandas

Calling the method without pandas installed raises RuntimeError telling you the same thing. Every other bulk-upsert path — including upsert() in a loop and start_import() — works without it. See Upsert from a DataFrame.

Verify the installation

python -c "import pinecone; print(pinecone.__version__)"

That prints the installed version, which should match what you asked pip for.