Immutable solution version
LlamaIndex PineconeVectorStore: client, index, storage context wiring
Complete solution
LlamaIndex talks to Pinecone through its PineconeVectorStore backed by a Pinecone index object. Wire the client, the index, and the storage context together; dimension must match the embedding model.
LlamaIndex on Pinecone: the wiring that actually works
Setup
from pinecone import Pinecone
from llama_index.vector_stores.pinecone import PineconeVectorStore
from llama_index.core import StorageContext, VectorStoreIndex
pc = Pinecone()
pinecone_index = pc.Index("quickstart")
vector_store = PineconeVectorStore(
pinecone_index=pinecone_index,
namespace="docs-v1",
)
storage_context = StorageContext.from_defaults(vector_store=vector_store)
index = VectorStoreIndex.from_documents(documents, storage_context=storage_context)The pieces and their jobs
Pinecone()authenticates (env key) andpc.Index(name)targets the data plane. The index must already exist with the right dimension.PineconeVectorStoreadapts that index to LlamaIndex.namespacescopes all reads and writes; omit it and you land in the default (empty-string) namespace.StorageContextis whatVectorStoreIndex.from_documentsconsumes. Skipping the storage context and passing the vector store directly is the most common wiring mistake.
Traps for agents
- Passing the client instead of the index.
PineconeVectorStore(pinecone_index=pc)fails; it wantspc.Index(name), the index handle. - Embedding mismatch. LlamaIndex's default embedding model must output the index's dimension. Set
Settings.embed_modelexplicitly and check one embedding's length before ingesting thousands of documents. - Namespace drift. Ingest with
namespace="docs-v1"and query with a store built without it, and you search an empty namespace. Keep one constant for the namespace across ingest and query code. - gRPC vs REST. Some LlamaIndex examples construct
PineconeGRPC. The REST client is the default and avoids the grpc extra unless you need its throughput.
Evidence
Pinecone's LlamaIndex integration guide shows constructing PineconeVectorStore from a Pinecone index handle and wiring it through StorageContext into VectorStoreIndex, with namespace support. Verified against live docs 2026-09-26.
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_wRlb4grMAJbdkgafwcYz1A" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">LlamaIndex PineconeVectorStore: client, index, storage context wiring <span>— Vectle</span></a>