> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celesto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Agentor and configure LLM providers

> Install the Agentor Python framework on macOS, Linux, or Windows with pip or uv, pick the optional extras you need, and set up your LLM provider API keys.

## Requirements

Before installing Agentor, make sure you have:

* **Python 3.11 or higher** — check your version with `python --version`
* **pip** or **uv** package manager
* An API key from your LLM provider (OpenAI, Anthropic, Google, and [many more](/agentor/model-providers))

## Install from PyPI

Agentor 0.1.0 is a **prerelease**. Ask for it explicitly with `--pre`:

```bash theme={null}
pip install --pre agentor
```

<Warning>
  Plain `pip install agentor` and `pip install --upgrade agentor` still give you the stable 0.0.x line. That is deliberate: 0.1.0 rebuilt the agent engine, and nobody is moved onto it without asking. See the [0.1.0a1 release notes](https://github.com/CelestoAI/agentor/releases) for what changed.
</Warning>

To stay on the stable line instead:

```bash theme={null}
pip install agentor
```

<Tip>
  For faster dependency resolution and better virtual environment management, use [uv](https://github.com/astral-sh/uv). On macOS and Linux:

  ```bash theme={null}
  curl -LsSf https://astral.sh/uv/install.sh | sh
  uv pip install --prerelease=allow agentor
  ```
</Tip>

## Install from source

To install the latest development version directly from GitHub:

```bash theme={null}
pip install git+https://github.com/celestoai/agentor@main
```

<Warning>
  The development version may contain unreleased features and breaking changes. Use this only if you need cutting-edge features or want to contribute.
</Warning>

## Optional dependencies

The core install stays small. Tools that need a heavyweight SDK live behind an extra, so you only download what you use.

| Extra         | Install                                    | Needed by                                                                                                |
| ------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
| `google`      | `pip install --pre "agentor[google]"`      | [`GmailTool`](/agentor/api/tools/gmail), [`CalendarTool`](/agentor/api/tools/google-calendar), SuperAuth |
| `exa`         | `pip install --pre "agentor[exa]"`         | `ExaSearchTool`                                                                                          |
| `git`         | `pip install --pre "agentor[git]"`         | [`GitTool`](/agentor/api/tools/git)                                                                      |
| `github`      | `pip install --pre "agentor[github]"`      | [`GitHubTool`](/agentor/api/tools/github)                                                                |
| `postgres`    | `pip install --pre "agentor[postgres]"`    | `PostgreSQLTool`                                                                                         |
| `slack`       | `pip install --pre "agentor[slack]"`       | `SlackTool`                                                                                              |
| `scrapegraph` | `pip install --pre "agentor[scrapegraph]"` | [`ScrapeGraphAI`](/agentor/api/tools/scrapegraphai)                                                      |
| `all`         | `pip install --pre "agentor[all]"`         | Everything above                                                                                         |

<Info>
  **Google tools moved in 0.1.0.** The Google API client and SuperAuth are roughly 100 MB and used to be installed for everyone. They are now in the `google` extra. If `GmailTool` or `CalendarTool` raises an `ImportError`, run `pip install --pre "agentor[google]"`.
</Info>

<Info>
  The `scrapegraph` extra requires **Python 3.12 or newer**, because `scrapegraph-py>=2.1.0` ships no wheels for 3.11. On 3.11 the extra installs but the SDK is skipped, and instantiating `ScrapeGraphAI` raises `ImportError`. See the [ScrapeGraphAI tool reference](/agentor/api/tools/scrapegraphai) for the full capability surface.
</Info>

## Set up environment variables

Agentor reads provider credentials from the environment. Create a `.env` file in your project root:

```bash .env theme={null}
# OpenAI (for gpt-4o, 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=...
```

<Note>
  You only need the key for the provider you plan to use. Agentor reaches most providers through their [OpenAI-compatible endpoint](/agentor/model-providers), and the rest through LiteLLM.
</Note>

## Load environment variables

In your Python code, load the environment variables:

```python theme={null}
import dotenv

dotenv.load_dotenv()
```

Or set them directly in your shell:

```bash theme={null}
export OPENAI_API_KEY=sk-...
export CELESTO_API_KEY=...
```

## Verify installation

Confirm Agentor is installed correctly:

```python theme={null}
import agentor

print(agentor.__version__)
```

You should see `0.1.0a1` on the prerelease, or a `0.0.x` version on the stable line.

<Check>
  `import agentor` should return almost instantly. Heavy dependencies are loaded only when something actually needs them.
</Check>

## Enable observability (optional)

To turn on tracing and monitoring, set your Celesto API key:

```bash theme={null}
export CELESTO_API_KEY=your_api_key
```

Get your key from the [Celesto dashboard](https://celesto.ai/dashboard).

Tracing is off unless you ask for it. Opt in on the agent, or on a single call:

```python theme={null}
from agentor import Agentor

agent = Agentor(
    name="My Agent",
    model="gpt-5-mini",
    enable_tracing=True,   # trace every run this agent makes
)

# Or trace one call from an otherwise-untraced agent.
agent.run("Debug this", tracing=True)
```

View traces at [celesto.ai/observe](https://celesto.ai/observe). See [Tracing](/agentor/tracing) for the full guide.

## Next steps

<CardGroup cols={2}>
  <Card title="Quick start" icon="bolt" href="/agentor/quickstart">
    Build your first agent in under 5 minutes.
  </Card>

  <Card title="Model providers" icon="plug" href="/agentor/model-providers">
    Point Agentor at OpenRouter, Groq, Ollama, or any compatible endpoint.
  </Card>

  <Card title="Model settings" icon="gear" href="/agentor/api/model-settings">
    Tune temperature, token limits, and other generation parameters.
  </Card>

  <Card title="Durable runs" icon="floppy-disk" href="/agentor/durable-runs">
    Save runs so a new process can finish them after a crash.
  </Card>
</CardGroup>