# pinecone-python-client

> The Pinecone Python client 

- **URL**: https://www.freshcrate.ai/projects/pinecone-python-client
- **Author**: pinecone-io
- **Category**: Uncategorized
- **Latest version**: `v9.1.0` (2026-06-04)
- **License**: Apache-2.0
- **Source**: https://github.com/pinecone-io/pinecone-python-client
- **Homepage**: https://www.pinecone.io/docs
- **Language**: Python
- **GitHub**: 432 stars, 121 forks
- **Registry**: github
- **Tags**: `python`

## Description

The Pinecone Python client

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v9.1.0` | 2026-06-04 | High | # Release v9.1.0  v9.1.0 is the retry-resilience release. It overhauls how the SDK behaves under throttling: decorrelated jitter on every transport, plus automatic per-host concurrency back-off that shrinks in-flight bulk requests during a 429 storm and recovers as pressure eases. A new `RateLimitError` lets callers catch throttling distinctly, and a dedicated retries guide documents the full model. Secondary changes round out `GrpcIndex` parity with the REST clients and restore the v8 `search |
| `v9.0.1` | 2026-05-19 | High | # Release v9.0.1  v9.0.1 is a polish release. It rolls up two weeks of fixes against backend response shapes, new client-side validation, completes the gRPC namespace API, widens public input types for ergonomic flexibility, and lands a deep pass on docstrings and migration guidance.   ---  ## Highlights  - **Several methods, parameters, and fields omitted from v9.0.0 are restored.** Highlights include the gRPC namespace operations (`create_namespace`, `describe_namespace`, `delete_names |
| `v9.0.0` | 2026-05-04 | High | # Release v9.0.0  v9 is a total rewrite of the Pinecone Python SDK. Rewrites are always ambitious undertakings, and we were motivated by three outcomes that had become difficult to achieve incrementally on the v8 codebase:  - **A substantially simpler installation** — one `pip install` covering all transports, with a much smaller dependency tree. - **Meaningful end-to-end performance improvements** — see the [Performance](#performance) section for initial measurements of performance on quer |
| `v8.1.2` | 2026-04-08 | High | ## What's Changed * Fix AttributeError on delete with non-dict response (#564) by @jhamon in https://github.com/pinecone-io/pinecone-python-client/pull/634 * Fix on-merge workflow permissions for dependency tests by @jhamon in https://github.com/pinecone-io/pinecone-python-client/pull/635   **Full Changelog**: https://github.com/pinecone-io/pinecone-python-client/compare/v8.1.1...v8.1.2 |
| `v8.1.1` | 2026-04-02 | Medium | ## Bug fixes    - Fix crash when delete() receives an empty response body — The asyncio delete() and delete_namespace() methods could crash with an AttributeError when   the server returned an empty response body. These methods now return None gracefully instead of crashing. (#623, fixes   #564)  ## Security & dependency updates    - Bump orjson minimum to 3.11.6 (CVE-2025-67221) (#625)   - Bump aiohttp to 3.13.5 in lockfile (CVE-2026-22815) (#630)   - Bump pygments to 2.20.0 in lockfi |
| `v8.1.0` | 2026-02-19 | Low | This release adds support for creating and configuring index `read_capacity` for BYOC indexes:  ```python import pinecone from pinecone import ByocSpec  pc = pinecone.Pinecone(api_key="YOUR_API_KEY")  # Create a BYOC index with OnDemand read capacity pc.create_index(     name="my-byoc-index",     dimension=1536,     spec=ByocSpec(         environment="my-byoc-env",         read_capacity={"mode": "OnDemand"},     ) )  # Create a BYOC index with Dedicated read capacity pc.create |
| `v8.0.1` | 2026-02-11 | Low | ## Security  **🔒 Fixed Protobuf Denial-of-Service Vulnerability (CVE-2025-4565)**  Updated protobuf dependency to address a denial-of-service vulnerability when parsing deeply nested recursive structures in a Pure-Python backend.  **Affected users:** Only users of the `grpc` extras (`pip install pinecone[grpc]`) and `PineconeGRPC` client will be affected by the change. Users of the default REST client (`Pinecone`) are not affected.  **Changes:** - Upgraded `protobuf` from `5.x` to `6.3 |
| `v8.0.0` | 2025-11-18 | Low | ## Upgrading from `7.x` to `8.x`  The v8 release of the Pinecone Python SDK has been published as `pinecone` to PyPI.   With a few exceptions noted below, nearly all changes are additive and non-breaking. The major version bump primarily reflects the step up to API version `2025-10` and the addition of a new dependency on `orjson` for fast JSON parsing.  ### Breaking Changes  ⚠️ **Python 3.9 is no longer supported.** The SDK now requires Python 3.10 or later. Python 3.9 reached end-of-li |
| `v7.3.0` | 2025-06-27 | Low | This minor release includes the ability to interact with the Admin API and adds support for working with index namespaces via gRPC. Previously, namespace support was available only through REST.   ## Admin api  This release introduces an Admin class that provides support for performing CRUD operations on projects and API keys using REST.  ### Projects  ```python from pinecone import Admin  # Use service account credentials admin = Admin(client_id='foo', client_secret='bar')  # Exam |
| `v7.2.0` | 2025-06-18 | Low | This minor release includes new methods for working with index namespaces via REST, and the ability to configure an index with the `embed` configuration, which was not previously exposed.  ## Working with namespaces  The `Index` and `IndexAsyncio` classes now expose methods for calling `describe_namespace`, `delete_namespace`, `list_namespaces`, and `list_namespaces_paginated`. There is also a `NamespaceResource` which can be used to perform these operations. Namespaces themselves are still |

## Citation

- HTML: https://www.freshcrate.ai/projects/pinecone-python-client
- Markdown: https://www.freshcrate.ai/projects/pinecone-python-client.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/pinecone-python-client/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._