Advanced Installation

Complete installation guide for PandaAGI SDK

System Requirements

Before installing PandaAGI SDK, ensure your system meets the following requirements:

Python Version

• Python 3.9 or higher
• Python 3.11+ recommended for best performance

Operating System

• Linux (Ubuntu 18.04+, CentOS 7+)
• macOS 10.15+
• Windows 10+ (with WSL2 recommended)

Dependencies

• Docker (for environment isolation)

Installation Methods

pip (Recommended)

# The easiest way to install PandaAGI SDK
pip install panda-agi

# For the latest development version
pip install git+https://github.com/panda-agi/sdk.git

From Source

For development or the latest features:

1. Clone the Repository

   git clone https://github.com/panda-agi/sdk.git
   cd panda-agi-sdk
   
2. Install Dependencies

   pip install -e .
   

   Or with Poetry:

   poetry install
   
3. Verify Installation

   python -c "import panda_agi; print(panda_agi.__version__)"
   

API Key Configuration

To use PandaAGI SDK, you need an API key that you can obtain from the PandaAGI platform:

1. Get Your API Key

   1. Visit https://agi.pandas-ai.com/
   2. Sign in with your GitHub account
   3. Navigate to your dashboard to access your API keys
   4. Copy your PANDA_AGI_KEY
2. Set Environment Variable

   Configure your API key as an environment variable:

   .env File (Recommended)

   Create a .env file in your project root:

   # .env file
   PANDA_AGI_KEY=your-api-key-here
   

   Linux/macOS

   Set in your shell profile for persistence:

   # Add to ~/.bashrc or ~/.zshrc
   PANDA_AGI_KEY="your-api-key-here"
   

   Then reload your profile:

   source ~/.bashrc  # or source ~/.zshrc if using zsh
   

   Windows

   # Set permanently via System Environment Variables
   # Open System Properties > Advanced > Environment Variables
   # Or via PowerShell:
   [Environment]::SetEnvironmentVariable("PANDA_AGI_KEY", "your-api-key-here", "User")
   
3. Verify Configuration

   Test that your API key is properly configured:

   import os
   
   api_key = os.getenv('PANDA_AGI_KEY')
   if api_key:
       print("✅ API key configured successfully")
   else:
       print("❌ API key not found")
   
4. Set in Python Code (Alternative)

   You can also set the API key directly in your Python code:

   import os
   
   # Set the API key in your environment variables
   os.environ['PANDA_AGI_KEY'] = 'your-api-key-here'
   
   # Now you can import and use PandaAGI
   from panda_agi import Agent
   

   Setting the API key this way only persists for the current Python process. For production applications, consider using environment variables, a .env file with python-dotenv, or a secure configuration manager like AWS Secrets Manager or HashiCorp Vault.

Environment Variables

Configure your environment with the required API keys:

.env File (Recommended)

Create a .env file in your project root:

# Required: PandaAGI API Key (get from https://agi.pandas-ai.com/)
PANDA_AGI_KEY=your-panda-agi-api-key

# Optional: Tavily API Key for enhanced web search functionality
TAVILY_API_KEY=your-tavily-api-key

OS Environment Variables

Linux/macOS

Add to your shell profile (~/.bashrc, ~/.zshrc):

# Required: PandaAGI API Key
PANDA_AGI_KEY="your-panda-agi-api-key"

# Optional: Tavily API Key
TAVILY_API_KEY="your-tavily-api-key"

Windows

Set via System Environment Variables or PowerShell:

# Set environment variables permanently
[Environment]::SetEnvironmentVariable("PANDA_AGI_KEY", "your-panda-agi-api-key", "User")
[Environment]::SetEnvironmentVariable("TAVILY_API_KEY", "your-tavily-api-key", "User")

Important: Keep your API keys secure and never commit them to version control. For production use, consider secure key management systems like AWS Secrets Manager, HashiCorp Vault, or environment-specific configuration services.

Docker Setup

For isolated general AI agent environments, install Docker:

Ubuntu/Debian

# Update package index
sudo apt-get update

# Install Docker
sudo apt-get install docker.io

# Start Docker service
sudo systemctl start docker
sudo systemctl enable docker

# Add user to docker group
sudo usermod -aG docker $USER

macOS

# Install Docker Desktop
brew install --cask docker

# Or download from https://docker.com/products/docker-desktop

Windows

# Install Docker Desktop for Windows
# Download from https://docker.com/products/docker-desktop

# Or using Chocolatey
choco install docker-desktop

Next Steps

Now that you have PandaAGI SDK installed, check out:

Quickstart

Build your first general AI agent in minutes

Architecture

Understand the fundamental concepts