Skip to main content
Pinecone is a managed vector database service that provides high-performance similarity search. It is available as a community-maintained adapter for Cognee.
Cognee can use Pinecone as a vector store backend through this community-maintained adapter.

Installation

This adapter is a separate package from core Cognee. Before installing, complete the Cognee installation and ensure your environment is configured with LLM and embedding providers. After that, install the adapter package:
pip install cognee-community-vector-adapter-pinecone

Registration

Unlike built-in providers, community adapters must be explicitly registered at the start of your script before calling any Cognee functions. This registers Pinecone in Cognee’s list of known vector database providers:
from cognee_community_vector_adapter_pinecone import register

register()
If you skip this step, Cognee will not recognize pinecone as a valid provider and will raise a runtime error even if the package is installed.

Configuration

Get your API key from the Pinecone console and configure Cognee to use it.
from cognee_community_vector_adapter_pinecone import register
from cognee import config

# Must register before configuring or using Cognee
register()

config.set_vector_db_config({
    "vector_db_provider": "pinecone",
    "vector_db_url": "https://your-index-host.pinecone.io",
    "vector_db_key": "your_pinecone_api_key",
})

Important Notes

Pinecone is not bundled with the default Cognee package. You must install and register the community adapter before configuring VECTOR_DB_PROVIDER=pinecone.
The register() call must happen before any Cognee vector operations in each process. It is not persisted — you cannot register once and skip it on subsequent runs. Add it at the top of your entry-point script or application startup code.
If you set VECTOR_DB_PROVIDER=pinecone before installing and registering the adapter, Cognee will raise this runtime error:
EnvironmentError: Unsupported vector database provider: pinecone
Complete the installation and registration steps above before configuring Pinecone.
Ensure EMBEDDING_DIMENSIONS matches the dimensions configured in your Pinecone index. A mismatch will cause errors when upserting vectors.See Embedding Providers for configuration details.

Resources

Adapter Source

GitHub repository

Pinecone Docs

Official Pinecone documentation

Vector Stores

Official vector providers

Community Overview

All community integrations

Setup Overview

Configuration guide