Account Setup & API Keys

Pinecone is a fully managed service — no infrastructure to provision. Let's get you set up.

Creating Your Account

1. Sign Up

Go to pinecone.io and click "Sign Up Free".

2. Verify Email

Check your inbox and verify your email address.

3. Choose Your Region

Pinecone offers multiple regions:

Getting Your API Key

1. Navigate to API Keys

In the Pinecone Console:

1. 1 Click your profile (top right)
2. 2 Select "API Keys"

2. Create a New Key

# Name your key descriptively
Name: my-app-production

3. Copy the Key

# Example API key format
PINECONE_API_KEY="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Environment Setup

Python Installation

pip install pinecone-client

Environment Variables

Create a .env file:

PINECONE_API_KEY=your-api-key-here
PINECONE_ENVIRONMENT=us-east-1

Load it in Python:

from dotenv import load_dotenv
import os

load_dotenv()

api_key = os.getenv("PINECONE_API_KEY")
environment = os.getenv("PINECONE_ENVIRONMENT")

Verify Connection

import pinecone

# Initialize
pinecone.init(
    api_key=api_key,
    environment=environment
)

# List indexes (should return empty list initially)
print(pinecone.list_indexes())
# Expected: []

Understanding Projects

Pinecone uses projects for organization:

• Default project — Created automatically
• Indexes — Belong to a project
• API keys — Can be project-scoped

Creating a New Project

1. 1 Go to Console → Projects
2. 2 Click "Create Project"
3. 3 Name it (e.g., "production", "staging")

Best Practices

API Key Management

Security Checklist

• [ ] Use separate keys per environment
• [ ] Rotate keys regularly
• [ ] Restrict key permissions (read-only where possible)
• [ ] Monitor key usage in console
• [ ] Revoke unused keys

Next Steps

Now that you're set up, create your first index:

→ Your First Index