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

# Installation

> Install and verify the Flint AI Python SDK

Install the Flint AI Python SDK to route your LLM traffic through the guardrails proxy. The SDK wraps your existing LLM client with a single function call — no code changes needed beyond the initial setup.

## Requirements

* **Python 3.10 or later** (3.10, 3.11, 3.12, 3.13)
* **pip** package manager

## Install the SDK

```bash theme={null}
pip install flintai-sdk-py
```

This installs the core SDK with no provider dependencies. To include your LLM provider's library automatically, install with an extra:

```bash theme={null}
pip install "flintai-sdk-py[openai]"     # OpenAI
pip install "flintai-sdk-py[anthropic]"  # Anthropic
pip install "flintai-sdk-py[genai]"      # Google GenAI
pip install "flintai-sdk-py[adk]"        # Google ADK (includes Google GenAI)
pip install "flintai-sdk-py[langchain]"  # LangChain (OpenAI, Anthropic, Google GenAI)
pip install "flintai-sdk-py[all]"        # All providers and tools
```

<Accordion title="Provider extras and version ranges">
  | Extra         | Packages installed                                                                                |
  | ------------- | ------------------------------------------------------------------------------------------------- |
  | `[openai]`    | `openai >=2.40.0, <3`                                                                             |
  | `[anthropic]` | `anthropic >=0.105.2, <1`                                                                         |
  | `[genai]`     | `google-genai >=2.7, <3`                                                                          |
  | `[adk]`       | `google-adk >=2.1, <3` and `google-genai >=2.7, <3`                                               |
  | `[langchain]` | `langchain-openai >=1.2, <2`, `langchain-anthropic >=1.4, <2`, `langchain-google-genai >=4.2, <5` |
  | `[dotenv]`    | `python-dotenv >=1.2.2, <2` (for `.env` file support)                                             |
  | `[all]`       | All of the above                                                                                  |
</Accordion>

## Verify your installation

```bash theme={null}
python -c "import flintai; print(flintai.__version__)"
```

You should see the installed version number (such as `1.0.1`).

<Accordion title="Troubleshooting">
  **`error: externally-managed-environment`**

  On macOS and some Linux distributions, system Python is protected by [PEP 668](https://peps.python.org/pep-0668/). Use a virtual environment:

  ```bash theme={null}
  python -m venv .venv
  source .venv/bin/activate
  pip install flintai-sdk-py
  ```

  **Version conflicts with provider SDKs**

  If you already have an LLM provider SDK installed at a different version, pip may report a conflict. The SDK requires specific version ranges for compatibility — check the extras table above and upgrade your provider SDK if needed:

  ```bash theme={null}
  pip install --upgrade openai  # or anthropic, google-genai, etc.
  ```

  **`ModuleNotFoundError: No module named 'flintai'`**

  Ensure you're using the same Python environment where you installed the SDK. If using a virtual environment, activate it first.
</Accordion>

## Next steps

<CardGroup cols={2}>
  <Card title="Configuration" icon="sliders" href="/flintai/platform/python-sdk/configuration">
    Set up gateway URL, API keys, and environment variables
  </Card>

  <Card title="Monitor agents at runtime" icon="shield-halved" href="/flintai/platform/getting-started/runtime">
    Get your first traces in less than 10 minutes
  </Card>
</CardGroup>