{"library":"pinecone-plugin-assistant","title":"Pinecone Assistant Plugin","description":"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.","status":"active","version":"3.0.3","language":"en","source_language":"en","source_url":"https://github.com/pinecone-io/pinecone-python-client","tags":["pinecone","assistant","AI","RAG","vector database","LLM","plugin"],"install":[{"cmd":"pip install pinecone","lang":"bash","label":"Recommended (functionality bundled since pinecone SDK v7.0.0)"},{"cmd":"pip install pinecone-plugin-assistant","lang":"bash","label":"For older Pinecone SDK versions (prior to v7.0.0)"}],"dependencies":[{"reason":"This plugin's functionality is now bundled within the main Pinecone SDK (>=v7.0.0). Installing 'pinecone' is the primary way to use it.","package":"pinecone","optional":false}],"imports":[{"note":"The Assistant functionalities are accessed via `pc.assistant` after initializing the main Pinecone client.","symbol":"Pinecone","correct":"from pinecone import Pinecone"},{"note":"Required for defining chat messages when interacting with the assistant.","symbol":"Message","correct":"from pinecone_plugins.assistant.models.chat import Message"}],"quickstart":{"code":"import os\nfrom pinecone import Pinecone\nfrom pinecone_plugins.assistant.models.chat import Message\n\n# Ensure PINECONE_API_KEY is set as an environment variable\napi_key = os.environ.get('PINECONE_API_KEY', '')\nif not api_key:\n    raise ValueError(\"PINECONE_API_KEY environment variable not set.\")\n\npc = Pinecone(api_key=api_key)\n\nassistant_name = \"my-test-assistant\"\n\ntry:\n    # Create an assistant\n    assistant = pc.assistant.create_assistant(\n        assistant_name=assistant_name,\n        instructions=\"Answer questions concisely.\"\n    )\n    print(f\"Assistant '{assistant.name}' created.\")\n\n    # Example chat interaction\n    user_message = Message(content=\"What is the capital of France?\")\n    response = assistant.chat_completions(messages=[user_message])\n\n    print(\"Assistant's response:\")\n    for choice in response.choices:\n        print(choice.message.content)\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")\nfinally:\n    # Clean up (optional): delete the assistant\n    try:\n        pc.assistant.delete_assistant(assistant_name=assistant_name)\n        print(f\"Assistant '{assistant_name}' deleted.\")\n    except Exception as e:\n        print(f\"Failed to delete assistant: {e}\")\n","lang":"python","description":"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`)."},"warnings":[{"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.","message":"As 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.","severity":"breaking","affected_versions":"pinecone SDK >= 7.0.0"},{"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.","message":"When 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.","severity":"gotcha","affected_versions":"All versions bundled with pinecone SDK"},{"fix":"Upgrade your Python environment to 3.10 or newer.","message":"The 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.","severity":"breaking","affected_versions":"pinecone SDK >= 7.x.x (from November 2025 releases)"},{"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.","message":"Version 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.","severity":"gotcha","affected_versions":"pinecone-plugin-assistant == 0.1.2"},{"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.","message":"Version 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`.","severity":"gotcha","affected_versions":"pinecone-plugin-assistant == 2.0.0"}],"env_vars":null,"last_verified":"2026-04-06T00:00:00.000Z","next_check":"2026-07-05T00:00:00.000Z"}