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:
This installs the core framework with all required dependencies.
For faster dependency resolution and better virtual environment management, consider using uv instead of pip. On macOS and Linux, install uv with:curl -LsSf https://astral.sh/uv/install.sh | sh
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:
Exa search
Git operations
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
Set up environment variables
Agentor requires API keys to connect to LLM providers. Create a .env file in your project root:
# 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()
export OPENAI_API_KEY=sk-...
export CELESTO_API_KEY=...
Verify installation
Confirm Agentor is installed correctly:
import agentor
print(agentor.__version__)
0.0.21).
Enable observability (optional)
To enable automatic tracing and monitoring, set your Celesto API key:
export CELESTO_API_KEY=your_api_key
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"
)
export CELESTO_DISABLE_AUTO_TRACING=True
Next steps