Pinecone Docs

Get started

Add Pinecone to your AI agent or app in minutes. Build a knowledge retrieval agent, use your IDE assistant, or integrate the SDK directly.

Get Pinecone running in your agent or app. Install the Pinecone plugin for your AI coding tool to get started instantly, or follow a step-by-step path below.

Agent / LLM? Start here

If you’re an AI agent or LLM reading this page to generate Pinecone code, here’s the full working pattern as a single runnable script.


Get set up

To get started, you’ll need a Pinecone account and API key.

1. Create a Pinecone account

If you’re new to Pinecone, sign up at app.pinecone.io and choose a plan:

  • Starter plan (free): Free access to most features, but you’re limited to one cloud region and need to stay under Starter plan limits.
  • Builder plan ($20/month): Higher quotas than Starter and predictable flat pricing with no usage overages, plus the ability to create indexes in any supported cloud region. Ideal for small production apps.
  • Standard plan trial: 21 days and $300 in credits with access to Standard plan features and higher limits that let you test Pinecone at scale.

After signing up, you’ll receive an API key in the console. Save this key. You’ll need it to authenticate your requests to Pinecone.

2. Get a Pinecone API key

Create a new API key in the Pinecone console, or use the widget below to generate a key. If you don’t have a Pinecone account, the widget will sign you up for the free Starter plan.

Your generated API key:

Fastest: use your AI coding tool

Install the Pinecone plugin for your AI coding tool, then run the quickstart command. The plugin gives your agent up-to-date Pinecone API references, skills, and a bundled MCP server. The quickstart command walks you through setup with the official Pinecone CLI before generating and running sample code, so you end up with a reproducible setup instead of pasted snippets.

  • Claude Code

  • Cursor

  • Other IDEs

Set your API key, then install the Pinecone plugin for Claude Code:

Start Claude Code and run the quickstart command:

The plugin also includes other slash commands, such as /pinecone:query, for interactively querying your indexes.

Choose your path


Build a knowledge retrieval agent

Build an AI agent that uses Pinecone to retrieve knowledge and answer questions accurately. This demo shows Pinecone as a tool inside an agent, which is the same pattern you’d use in production.

1

2

3

4

5

Next steps


Integrate the SDK directly

Integrate Pinecone directly into your application. Use these SDK calls wherever your code needs knowledge retrieval, whether that’s an agent, a backend service, or a standalone script.

1. Install an SDK

2. Create an index

Create an index with integrated embedding so you can upsert and search with text. Pinecone generates the vectors for you.

Python

JavaScript, Java, and Go

3. Upsert data

Load records into your index. Each record has an ID, text content, and optional metadata. Pinecone converts the text to vectors automatically using the integrated embedding model.

Python

JavaScript, Java, and Go

4. Search and rerank

Search the index for records semantically similar to a query, then rerank for more accurate results.

Python

Output

JavaScript, Java, and Go

5. Clean up

When you no longer need the example index, delete it:

Python

JavaScript, Java, and Go

Next steps


No-code with n8n

Create an AI workflow that uses Pinecone for knowledge retrieval without writing any code. Use n8n to create a workflow that downloads files via HTTP and lets you chat with them using Pinecone Database and OpenAI.

1. Get an OpenAI API key

Create a new API key in the OpenAI console.

2. Create an index

Create an index in the Pinecone console:

  • Name your index n8n-dense-index
  • Under Configuration, check Custom settings and set Dimension to 1536.
  • Leave everything else as default.

3. Set up n8n

1

2

3

4

4. Chat with your docs

Once the workflow is activated, ask it for the latest changes to Pinecone Database:

Next steps

  • Use your own data:
    • Change the urls in Set file urls node to use your own files.
    • You may need to adjust the chunk sizes in the Recursive Character Text Splitter node or use a different chunking strategy. See Chunking Strategies for LLM Applications for more info.
    • Customize the system message of the AI Agent node to reflect what the Pinecone Vector Store Tool will be used for.
    • Customize the description of the Pinecone Vector Store Tool to reflect what data you are storing in the Pinecone index.
  • Use n8n, Pinecone Assistant, and OpenAI to chat with your Google Drive documents.
  • Get help in the Pinecone Discord community.

Read the original on docs.pinecone.io ↗