Skip to main content

​
Requirements

Before installing Agentor, ensure you have:
  • Python 3.10 or higher - Check your version with python --version
  • pip or uv package manager
  • An API key from your LLM provider (OpenAI, Anthropic, Google, etc.)

​
Install from PyPI

The recommended method is to install Agentor from PyPI using pip: 
pip install agentor
This installs the core framework with all required dependencies.
For faster dependency resolution and better virtual environment management, consider using uv instead of pip:
pip install uv
uv pip install agentor

​
Install from source

To install the latest development version directly from GitHub: 
pip install git+https://github.com/celestoai/agentor@main
The development version may contain unreleased features and breaking changes. Use this only if you need cutting-edge features or want to contribute.

​
Optional dependencies

Agentor provides optional dependencies for specific tools and integrations: 
pip install agentor[exa]

​
Git operations

pip install agentor[git]

​
GitHub integration

pip install agentor[github]

​
PostgreSQL database

pip install agentor[postgres]

​
Slack integration

pip install agentor[slack]

​
ScrapeGraph AI

pip install agentor[scrapegraph]

​
Install all optional dependencies

pip install agentor[all]

​
Set up environment variables

Agentor requires API keys to connect to LLM providers. Create a .env file in your project root:
.env
# OpenAI (for gpt-4, gpt-5, etc.)
OPENAI_API_KEY=sk-...

# Anthropic (for Claude models)
ANTHROPIC_API_KEY=sk-ant-...

# Google (for Gemini models)
GEMINI_API_KEY=...

# Celesto (for observability and deployment)
CELESTO_API_KEY=...
You only need the API key for the LLM provider you plan to use. Agentor supports 100+ LLM providers through LiteLLM.

​
Load environment variables

In your Python code, load the environment variables: 
import dotenv

dotenv.load_dotenv()
Or set them directly in your shell: 
export OPENAI_API_KEY=sk-...
export CELESTO_API_KEY=...

​
Verify installation

Confirm Agentor is installed correctly: 
import agentor

print(agentor.__version__)
You should see the version number printed (e.g., 0.0.21).

​
Enable observability (optional)

To enable automatic tracing and monitoring, set your Celesto API key: 
export CELESTO_API_KEY=your_api_key
Get your API key from the Celesto dashboard. When the CELESTO_API_KEY environment variable is set, Agentor automatically enables LLM monitoring and tracing: 
from agentor import Agentor

# Tracing enabled automatically if CELESTO_API_KEY is set
agent = Agentor(
    name="My Agent",
    model="gpt-5-mini"
)
View traces at https://celesto.ai/observe. To disable automatic tracing: 
export CELESTO_DISABLE_AUTO_TRACING=True

​
Next steps

Quick start

Build your first agent in under 5 minutes

Model settings

Learn about model settings and configuration options

Build docs developers (and LLMs) love

Get started for freeTalk to us