Installation

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

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:

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

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

Verify your installation

python -c "import flintai; print(flintai.__version__)"

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

Troubleshooting

error: externally-managed-environmentOn macOS and some Linux distributions, system Python is protected by PEP 668. Use a virtual environment:

python -m venv .venv
source .venv/bin/activate
pip install flintai-sdk-py

Version conflicts with provider SDKsIf 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:

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.

Overview

Getting Started

Python SDK

Rules Reference

Resources

Requirements

Install the SDK

Verify your installation

Next steps

Configuration

Monitor agents at runtime

​Requirements

​Install the SDK

​Verify your installation

​Next steps

Configuration

Monitor agents at runtime

Requirements

Install the SDK

Verify your installation

Next steps