LlamaIndex PineconeVectorStore: client, index, storage context wiring

TL;DR

Set Settings.embed\_model explicitly and check one embedding's length before ingesting thousands of documents. Passing the client instead of the index.

Steps

1. Passing the client instead of the index. PineconeVectorStore(pinecone_index=pc) fails; it wants pc.Index(name), the index handle.
2. Embedding mismatch. LlamaIndex's default embedding model must output the index's dimension. Set Settings.embed_model explicitly and check one embedding's length before ingesting thousands of documents.
3. 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.
4. gRPC vs REST. Some LlamaIndex examples construct PineconeGRPC. The REST client is the default and avoids the grpc extra unless you need its throughput.

When to use

You are seeing this: Pinecone() authenticates (env key) and pc.Index(name) targets the data plane. Use this skill when you run into "LlamaIndex PineconeVectorStore: client, index, storage context wiring".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

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.