Pinecone Client Migration Assistant

This skill helps you migrate from the deprecated `pinecone-client` package to the new `pinecone` package safely and correctly.

Overview

The official Pinecone Python package has been renamed from `pinecone-client` to `pinecone`. This migration is critical because having both packages installed simultaneously can cause confusing interactions and conflicts.

Instructions

When a user needs to migrate from `pinecone-client` to `pinecone`, follow these steps:

Step 1: Check Current Installation

First, verify which Pinecone packages are currently installed:

```bash

pip list | grep pinecone

```

Document what's installed so the user understands their starting point.

Step 2: Determine gRPC Requirement

Ask the user if they are using gRPC functionality with Pinecone. This determines which installation command to use later.

Step 3: Remove Deprecated Package

Uninstall the deprecated `pinecone-client` package completely:

```bash

pip uninstall pinecone-client -y

```

**CRITICAL:** This must be done before installing the new package to avoid conflicts.

Step 4: Install New Package

Install the appropriate version of the new package:

**For standard installation:**

```bash

pip install pinecone

```

**For installation with gRPC support:**

```bash

pip install "pinecone[grpc]"

```

Step 5: Update Import Statements

Guide the user to update their Python code. The package name in import statements should be checked:

**Old imports (may need updating):**

```python

import pinecone_client

```

**New imports:**

```python

import pinecone

```

Note: If imports were already using `import pinecone`, they may not need changes, but the user should verify functionality.

Step 6: Review Breaking Changes

Direct the user to review potential breaking changes:

Ask if they need help understanding or implementing any specific changes documented there.

Step 7: Update Dependency Files

Remind the user to update their dependency management files:

Step 8: Verify Installation

Run a verification check:

```bash

pip show pinecone

```

Confirm the package is installed correctly and note the version number.

Constraints

Common Issues

Resources