●Change8

Migrating to Pinecone Client v9.0.0

Version v9.0.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 5/4/2026

2
Breaking Changes
3
Migration Steps
8
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

pinecone.Pineconepc.indexpc.indexespc.collectionspc.backupspc.inferencepc.assistantpc.preview

Breaking Changes

●Issue #1

The client organization is now resource-oriented (e.g., use `pc.indexes.create` instead of flat v8 method names). Deprecated aliases for v8 flat method names are in place, but code changes may be required.

●Issue #2

Python 3.9 is no longer supported; Python 3.10+ is now required.

Migration Steps

  1. 1
    Update installation command to `pip install pinecone`. Extras like `[grpc]` or `[asyncio]` are obsolete.
  2. 2
    Update code to use the new resource-oriented client structure (e.g., `pc.indexes.create` instead of old flat methods). Check the migration guide for specific signature changes.
  3. 3
    Ensure the environment uses Python 3.10 or newer.

Release Summary

Version 9.0.0 is a complete rewrite of the Pinecone Python SDK, focusing on simplified installation, substantial performance gains via new serialization/transport layers, and a cleaner, resource-oriented client architecture. Python 3.10+ is now required.

Need More Details?

View the full release notes and all changes for Pinecone Client v9.0.0.

View Full Changelog