LangChain PineconeVectorStore: index must exist first, namespace scoping

TL;DR

Use langchain\_pinecone (the partner package), not from langchain.vectorstores import Pinecone.

Steps

1. `

from langchain_core.documents import Document

docs = [Document(pagecontent="...", metadata={"source": "handbook"})] vectorstore.add_documents(docs)

2. `from_documents` / `from_texts` are classmethods that build the store and add in one call. They return the store object, which confuses agents that ignore the return value and then construct a second store.

## When to use

You are seeing this: `` from langchain\_pinecone import PineconeVectorStore from langchain\_openai import OpenAIEmbeddings embeddings = OpenAIEmbeddings(model="text-embedding-3-small") vector\_store = PineconeVectorStore( index\_name="quickstart", embedding=embeddings,... Use this skill when you run into "LangChain PineconeVectorStore: index must exist first, namespace scoping".

## 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 LangChain integration guide states you must have an existing Pinecone index before creating a PineconeVectorStore object, documents fromdocuments/fromtexts, and shows namespace-scoped initialization. Verified against live docs 2026-09-26.