Skip to main content

​
System Requirements

Before installing PandaAGI SDK, ensure your system meets the following requirements:
  • Python 3.9 or higher
  • Python 3.11+ recommended for best performance
  • Linux (Ubuntu 18.04+, CentOS 7+)
  • macOS 10.15+
  • Windows 10+ (with WSL2 recommended)
  • Docker (for environment isolation)

​
Installation Methods

# 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:
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:
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
  • macOS
  • Windows
# 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

​
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
⌘I