Installation¶

This guide will help you install Agentle and its dependencies.

Basic Installation¶

You can install Agentle using pip:

pip install agentle

This will install the core Agentle package with minimal dependencies.

Installing with Optional Dependencies¶

Agentle has several optional dependencies for different features:

# Install with all optional dependencies
pip install "agentle[all]"

# Install with specific dependency groups
pip install "agentle[google]"     # Google AI integration
pip install "agentle[langfuse]"   # Langfuse observability
pip install "agentle[http]"       # BlackSheep ASGI server
pip install "agentle[streamlit]"  # Streamlit UI integration
pip install "agentle[cache]"      # Caching support (aiocache)

You can also combine dependency groups:

# Install with Google AI and Langfuse
pip install "agentle[google,langfuse]"

# Install for deployment with Google AI
pip install "agentle[google,asgi,langfuse]"

Installation from Source¶

To install the latest development version from source:

git clone https://github.com/paragon-intelligence/agentle.git
cd agentle
pip install -e .

Setting Up API Keys¶

Agentle requires API keys for the language model providers you plan to use:

Google AI¶

For Google AI models (Gemini), you’ll need a Google AI API key:

Visit the Google AI Studio
Click on “Get API key”
Follow the instructions to create a project and API key
Set the environment variable (or place it in your .env):

# Linux/macOS
export GOOGLE_API_KEY="your-google-api-key"

# Windows
set GOOGLE_API_KEY=your-google-api-key

OpenAI¶

For OpenAI models, you’ll need an OpenAI API key:

Visit OpenAI API Keys
Create a new API key
Set the environment variable:

# Linux/macOS
export OPENAI_API_KEY="your-openai-api-key"

# Windows
set OPENAI_API_KEY=your-openai-api-key

Langfuse (for Observability)¶

To use Langfuse for tracing and observability:

Sign up at Langfuse
Create a new project
Go to Settings → API Keys to get your Public and Secret keys
Set the environment variables:

# Linux/macOS
export LANGFUSE_PUBLIC_KEY="your-langfuse-public-key"
export LANGFUSE_SECRET_KEY="your-langfuse-secret-key"
export LANGFUSE_HOST="https://cloud.langfuse.com"  # Optional

# Windows
set LANGFUSE_PUBLIC_KEY=your-langfuse-public-key
set LANGFUSE_SECRET_KEY=your-langfuse-secret-key
set LANGFUSE_HOST=https://cloud.langfuse.com

System Requirements¶

Agentle requires Python 3.13 or higher, with the following specifications:

Python 3.13+
2GB RAM minimum (4GB+ recommended)
500MB disk space

Compatibility¶

Agentle has been tested on the following platforms:

Ubuntu 20.04+ (Linux)
macOS 11+ (Big Sur or later)
Windows 10/11
Python 3.13+

Troubleshooting¶

If you encounter any installation issues:

Ensure you have the latest pip version:
```
pip install --upgrade pip
```
Check for Python version compatibility:
```
python --version
```

For SSL certificate errors, you may need to:

pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org agentle

If you see errors about aiocache when using knowledge integration with caching, install the optional dependency:
```
pip install aiocache
```

Next Steps¶

Once Agentle is installed, you can:

Check out the Quickstart guide to create your first agent
Explore the core concepts of the framework
Try the examples in the GitHub repository