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:
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:

Install from source

To install the latest development version directly from GitHub:
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:

Git operations

GitHub integration

PostgreSQL database

Slack integration

ScrapeGraph AI

The scrapegraph extra requires Python 3.12 or newer because scrapegraph-py>=2.1.0 does not ship wheels for Python 3.10 or 3.11. On older interpreters, the extra installs but the SDK is skipped, and instantiating ScrapeGraphAI raises ImportError. See the ScrapeGraphAI tool reference for the full capability surface.

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:
.env
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:
Or set them directly in your shell:

Verify installation

Confirm Agentor is installed correctly:
You should see the version number printed (e.g., 0.0.22).

Enable observability (optional)

To enable automatic tracing and monitoring, set your Celesto 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:
View traces at https://celesto.ai/observe. To disable automatic tracing:

Next steps

Quick start

Build your first agent in under 5 minutes

Model settings

Learn about model settings and configuration options
Last modified on July 17, 2026