pinecone-io/python-sdk

Official Python SDK for the Pinecone vector database

What it solves

This SDK provides a Python interface for interacting with the Pinecone vector database, allowing developers to store, manage, and retrieve high-dimensional vector embeddings for AI applications.

How it works

The library acts as a client that connects to the Pinecone API. It allows users to create serverless indexes, upload (upsert) vectors into specific namespaces, and perform similarity queries to find the most relevant vectors based on a provided embedding.

Who it’s for

Python developers building AI applications that require a scalable vector database for tasks like semantic search or recommendation systems.

Highlights

  • Async Support: Includes an AsyncPinecone client for use with asyncio to handle concurrent requests.
  • Automatic Batching: Automatically splits large vector inputs into parallel batches during the upsert process.
  • Flexible Configuration: Supports API key management via environment variables and custom host/timeout settings.
  • Robust Testing: Includes a specialized smoke test suite to verify retry logic and adaptive concurrency against real API rate limits.