---
title: 'Installation'
description: 'Complete installation guide for PandaAGI SDK'
---

## System Requirements

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

<AccordionGroup>
  <Accordion title="Python Version">
    - Python 3.8 or higher
    - Python 3.11+ recommended for best performance
  </Accordion>

  <Accordion title="Operating System">
    - Linux (Ubuntu 18.04+, CentOS 7+)
    - macOS 10.15+
    - Windows 10+ (with WSL2 recommended)
  </Accordion>

  <Accordion title="Dependencies">
    - Docker (for environment isolation)
    - Git (for development)
    - 4GB+ RAM recommended
  </Accordion>
</AccordionGroup>

## Installation Methods

### Using pip (Recommended)

The easiest way to install PandaAGI SDK is using pip:

```bash
pip install panda-agi
```

For the latest development version:

```bash
pip install git+https://github.com/panda-agi/sdk.git
```

### Using Poetry

If you're using Poetry for dependency management:

```bash
poetry add panda-agi
```

### Using Conda

For Conda users:

```bash
conda install -c conda-forge panda-agi
```

### From Source

For development or the latest features:

<Steps>
  <Step title="Clone the Repository">
    ```bash
    git clone https://github.com/panda-agi/sdk.git
    cd panda-agi-sdk
    ```
  </Step>
  
  <Step title="Install Dependencies">
    ```bash
    pip install -e .
    ```
    
    Or with Poetry:
    ```bash
    poetry install
    ```
  </Step>
  
  <Step title="Verify Installation">
    ```bash
    python -c "import panda_agi; print(panda_agi.__version__)"
    ```
  </Step>
</Steps>

## Docker Setup

For isolated agent environments, install Docker:

<Tabs>
  <Tab title="Ubuntu/Debian">
    ```bash
    # 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
    ```
  </Tab>
  
  <Tab title="macOS">
    ```bash
    # Install Docker Desktop
    brew install --cask docker
    
    # Or download from https://docker.com/products/docker-desktop
    ```
  </Tab>
  
  <Tab title="Windows">
    ```powershell
    # Install Docker Desktop for Windows
    # Download from https://docker.com/products/docker-desktop
    
    # Or using Chocolatey
    choco install docker-desktop
    ```
  </Tab>
</Tabs>

## Environment Variables

Configure your environment for optimal performance:

```bash
# Optional: Set default model
export PANDA_AGI_MODEL="gpt-4"

# Optional: Set API keys
export OPENAI_API_KEY="your-openai-key"
export ANTHROPIC_API_KEY="your-anthropic-key"

# Optional: Configure Docker
export PANDA_AGI_DOCKER_IMAGE="python:3.11-slim"
```


## Next Steps

Now that you have PandaAGI SDK installed, check out:

<CardGroup cols={2}>
  <Card
    title="Quickstart Guide"
    icon="rocket"
    href="/quickstart"
  >
    Build your first agent in minutes
  </Card>
  <Card
    title="Core Concepts"
    icon="lightbulb"
    href="/concepts/agents"
  >
    Understand the fundamental concepts
  </Card>
</CardGroup> 