Pinecone diagnosis: LangChain vector store fails on a missing index

TL;DR: Symptom: PineconeVectorStore construction succeeds but the first operation fails. LangChain never creates the index; create it first with matching dimension. Confirm it 1. pc.list_indexes() with the raw Pinecone client: is the name there? Check the namespace: the store may target a namespace while you verified the default.

The fix

1. pc.list_indexes() with the raw Pinecone client: is the name there?
2. If present, describe_index: does its dimension match len(embeddings.embed_query('test'))?
3. Check the namespace: the store may target a namespace while you verified the default.
4. Create the index first (serverless spec, right dimension and metric), then construct the store.
5. Or point the store at the existing correct index.
6. Make index creation part of your setup script, ordered before any LangChain code runs.

When to use this

• You are seeing this exact error message; match the block above, not just part of it.
• The failing call matches the scenario in the title: Pinecone diagnosis.
• You want the fastest verified fix before digging through logs.

When not to use this

• Your error text differs from the block above; close cousins often have different causes.
• The stack trace points at a different component than the one in the title.
• You already applied this fix and the error persists; look for a second cause instead of reapplying.

Compatibility

• Not pinned to a specific version; follows current Pinecone behavior.

Pinecone's LangChain integration guide states an existing index is required before creating a PineconeVectorStore object. Verified against live docs 2026-09-26.