API_KEYS_SETUP.md

🔑 API Keys Setup Guide

How to Get Pinecone API Key

Step 1: Create Pinecone Account

1. Go to https://www.pinecone.io/
2. Click "Sign Up" or "Get Started Free"
3. Create account with your email or sign up with Google/GitHub
4. Verify your email address if required

Step 2: Access Dashboard

1. Log into your Pinecone account
2. You'll be taken to the Pinecone Console/Dashboard
3. Look for "API Keys" in the left sidebar or navigation menu

Step 3: Get Your API Key

1. Click on "API Keys" in the dashboard
2. You'll see your default API key listed
3. Click "Copy" or the copy icon next to the API key
4. Save this key securely - you'll need it for the application

How to Get Gemini API Key

Step 1: Go to Google AI Studio

1. Visit https://aistudio.google.com/
2. Sign in with your Google account

Step 2: Get API Key

1. Click "Get API Key" in the top navigation
2. Click "Create API Key"
3. Select your Google Cloud project (or create a new one)
4. Copy the generated API key

How to Get Tavily API Key

Step 1: Create Tavily Account

1. Go to https://app.tavily.com/
2. Click "Sign Up" and register with your email or use a social login
3. Verify your email address if prompted

Step 2: Access API Keys

1. Log into your Tavily account
2. Navigate to the "API Keys" section in your dashboard
3. Click "Create API Key" if you don't have one yet
4. Copy the generated API key and store it securely

🚀 Quick Start Guide

Option 1: Set Environment Variables Temporarily

Windows Command Prompt:

set PINECONE_API_KEY=pc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
set GEMINI_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
set TAVILY_API_KEY=tvly_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
python app.py

Windows PowerShell:

$env:PINECONE_API_KEY="pc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
$env:GEMINI_API_KEY="AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
$env:TAVILY_API_KEY="tvly_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
python app.py

Option 2: Create .env File (Recommended)

1. Create a file named .env in your project root:

PINECONE_API_KEY=pc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
GEMINI_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TAVILY_API_KEY=tvly_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  # Optional

2. Run the application:

python app.py

📋 Free Tier Information

Pinecone Free Tier:

• ✅ 1 project
• ✅ 1 index
• ✅ 100K vectors
• ✅ Perfect for hackathons and testing

Gemini Free Tier:

• ✅ 15 requests per minute
• ✅ 1 million tokens per day
• ✅ Sufficient for development and demos

Tavily Free Tier:

• ✅ Generous free tier for testing and development
• ✅ Check Tavily Pricing for current limits

🔧 Troubleshooting

If you get "Invalid API Key" errors:

1. Double-check the API key is copied correctly
2. Make sure there are no extra spaces
3. Verify the environment variable is set: echo %PINECONE_API_KEY%

If Pinecone connection fails:

1. Check your internet connection
2. Verify your Pinecone account is active
3. Make sure you're using the correct region (default is usually fine)

🎯 Ready to Launch

Once you have all API keys:

1. Set the environment variables
2. Run the application:

   python app.py
   

3. Open your browser to: http://localhost:7860
4. Start uploading documents and asking questions!

The application will now have full functionality with:

• ✅ Document processing and embedding
• ✅ Vector storage in Pinecone
• ✅ AI-powered question answering
• ✅ Beautiful Gradio interface

🎉 Your AI Embedded Knowledge Agent will be fully operational!