Registry / vector-search / pinecone-plugin-assistant

pinecone-plugin-assistant

library3.0.3pypypi✓ verified 24d ago

The `pinecone-plugin-assistant` library provides an interface for interacting with Pinecone's Assistant APIs, enabling users to create, manage, and chat with AI assistants. As of Pinecone Python SDK v7.0.0, the functionalities provided by this plugin are bundled directly within the main `pinecone` package. It is currently at version 3.0.3 and is actively maintained as part of the broader Pinecone ecosystem, with its release cadence tied to the main Pinecone SDK releases.

vector-search llm-agents ai-ml database

pip install pinecone

package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · PINECONE-PLUGIN-AS

pinecone-plugin-assistant

vector-searchpythonv3.0.3

Install

2.6s avg

Import

259ms

Disk

50MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v3.0.3 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.216s · 88.1MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 2.6s · import 0.198s · 24MB

50MB installed

● package 50MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Pinecone

✓ from pinecone import Pinecone

The Assistant functionalities are accessed via `pc.assistant` after initializing the main Pinecone client.

Message

✓ from pinecone_plugins.assistant.models.chat import Message

Required for defining chat messages when interacting with the assistant.

This quickstart demonstrates how to initialize the Pinecone client, create a new AI assistant, send a chat message to it, and receive a response. It includes basic error handling and cleanup. Ensure your Pinecone API key is set as an environment variable (`PINECONE_API_KEY`).

import os from pinecone import Pinecone from pinecone_plugins.assistant.models.chat import Message # Ensure PINECONE_API_KEY is set as an environment variable api_key = os.environ.get('PINECONE_API_KEY', '') if not api_key: raise ValueError("PINECONE_API_KEY environment variable not set.") pc = Pinecone(api_key=api_key) assistant_name = "my-test-assistant" try: # Create an assistant assistant = pc.assistant.create_assistant( assistant_name=assistant_name, instructions="Answer questions concisely." ) print(f"Assistant '{assistant.name}' created.") # Example chat interaction user_message = Message(content="What is the capital of France?") response = assistant.chat_completions(messages=[user_message]) print("Assistant's response:") for choice in response.choices: print(choice.message.content) except Exception as e: print(f"An error occurred: {e}") finally: # Clean up (optional): delete the assistant try: pc.assistant.delete_assistant(assistant_name=assistant_name) print(f"Assistant '{assistant_name}' deleted.") except Exception as e: print(f"Failed to delete assistant: {e}")

Debug

Known issues

breakingAs of Pinecone Python SDK v7.0.0, the functionality of `pinecone-plugin-assistant` is bundled directly into the main `pinecone` package. Installing `pinecone-plugin-assistant` separately is no longer required and may be redundant or cause conflicts if using `pinecone` v7.0.0 or newer.

fix

Only install `pinecone` (`pip install pinecone`). Do not install `pinecone-plugin-assistant` separately unless explicitly targeting older SDK versions. If migrating from older versions, remove `pinecone-plugin-assistant` from your dependencies.

affects: pinecone SDK >= 7.0.0

gotchaWhen using `pinecone-plugin-assistant` (especially when bundled with the main `pinecone` SDK), IDE autocomplete and intellisense tools may have difficulty recognizing the dynamically attached functionality, such as `pc.assistant.<method>`. This can lead to warnings about modules not existing or untyped elements in your IDE.

fix

Refer to official documentation and examples for correct method signatures. While IDE warnings may appear, the code should execute correctly if the methods are used as documented.

affects: All versions bundled with pinecone SDK

breakingThe main `pinecone` SDK (which now bundles assistant functionality) requires Python 3.10 or later. Python 3.9 is no longer supported as of the Pinecone SDK release on November 18, 2025.

fix

Upgrade your Python environment to 3.10 or newer.

affects: pinecone SDK >= 7.x.x (from November 2025 releases)

gotchaVersion 0.1.2 of `pinecone-plugin-assistant` had a critical bug where the API key was not correctly set on requests, resulting in `UnauthorizedException` (HTTP 401) errors.

fix

Upgrade to `pinecone-plugin-assistant` version 0.1.3 or higher. If using the bundled functionality, ensure your main `pinecone` SDK is up-to-date.

affects: pinecone-plugin-assistant == 0.1.2

gotchaVersion 2.0.0 of `pinecone-plugin-assistant` had a strict dependency pin on `packaging` (`>=24.2,<25.0`), which could cause dependency resolution conflicts with other libraries (e.g., `xai-sdk`) requiring `packaging >=25.0`.

fix

If encountering conflicts, try upgrading `pinecone-plugin-assistant` to a newer version (if available) or adjust your project's `packaging` dependency to satisfy all requirements, possibly by using dependency overrides if your package manager supports them. The broader recommendation is to use the bundled functionality in `pinecone` SDK >= 7.0.0.

affects: pinecone-plugin-assistant == 2.0.0

breakingThe Pinecone SDK requires an API key for authentication. If the `PINECONE_API_KEY` environment variable is not set, a `ValueError` will be raised when the SDK attempts to initialize or perform operations requiring authentication.

fix

Ensure the `PINECONE_API_KEY` environment variable is set with a valid Pinecone API key before running your application. You can obtain an API key from your Pinecone console.

affects: All versions of pinecone SDK

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'pinecone_plugins.assistant'

As of Pinecone Python SDK v7.0.0, the functionalities of `pinecone-plugin-assistant` are bundled directly within the main `pinecone` package, making the separate plugin unnecessary. This error occurs when trying to import from the old plugin path or if an older Pinecone SDK version (prior to v7.0.0) is used without explicitly installing `pinecone-plugin-assistant`.

fix

If using Pinecone SDK v7.0.0 or later, remove the explicit import of `pinecone_plugins.assistant` and access assistant functionalities directly via the `pinecone` client (e.g., `from pinecone import Pinecone; pc = Pinecone(...); assistant = pc.assistant`). If using an older Pinecone SDK version, ensure `pinecone-plugin-assistant` is installed via `pip install pinecone-plugin-assistant`.

AttributeError: module 'pinecone' has no attribute 'init'

The `pinecone.init()` method was deprecated and removed in newer versions of the Pinecone Python SDK (specifically v7.0.0 and later) in favor of direct instantiation of the `Pinecone` client object.

fix

Update your code to instantiate the `Pinecone` client directly: `from pinecone import Pinecone; pc = Pinecone(api_key='YOUR_API_KEY')`.

Because no versions of pinecone-plugin-assistant match >1.6.0,<1.6.1 || >1.6.1,<1.7.0 || >1.7.0,<1.8.0 || >1.8.0,<2.0.0 and pinecone-plugin-assistant (1.6.0) depends on packaging (>=24.2,<25.0), pinecone-plugin-assistant (>=1.6.0,<1.6.1 || >1.6.1,<1.7.0 || >1.7.0,<1.8.0 || >1.8.0,<2.0.0) requires packaging (>=24.2,<25.0).

This is a dependency conflict error, typically occurring when `pinecone-plugin-assistant` (or the main `pinecone` SDK which bundles it) has a strict version requirement for the `packaging` library that conflicts with another installed library in your environment.

fix

Try upgrading both `pinecone` and `pinecone-plugin-assistant` (if still separately installed) to their latest versions: `pip install --upgrade pinecone pinecone-plugin-assistant`. If the conflict persists, you may need to isolate the project in a virtual environment, or identify the conflicting library and attempt to find compatible versions for all dependencies.

UnauthorizedException: (401) Reason: Unauthorized HTTP response body: Invalid API Key.

This error most commonly indicates that the Pinecone API key provided is incorrect or missing. In an older version of `pinecone-plugin-assistant` (v0.1.2), there was a known bug where the API key was not being set correctly on requests.

fix

First, verify your Pinecone API key is correct and ensure it's being passed correctly during client initialization. If the key is definitely correct, ensure you are using the latest version of the Pinecone SDK (which includes the assistant functionality) or `pinecone-plugin-assistant` if using an older Pinecone SDK version, as the API key handling bug was fixed in `pinecone-plugin-assistant` v0.1.3. Upgrade using `pip install --upgrade pinecone`.

Upgrade

Version history

3.0.3latest on PyPI · released Mar 27, 2026

Audit

Dependencies

pineconerequiredThis plugin's functionality is now bundled within the main Pinecone SDK (>=v7.0.0). Installing 'pinecone' is the primary way to use it.

Agent activity

51 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/pinecone-plugin-assistant/ ↗

homepagehttps://www.pinecone.io ↗

docshttps://pinecone.io/docs ↗