Installation

Basic Installation

Install understudy from PyPI:

pip install understudy

Or with uv:

uv add understudy

Optional Dependencies

understudy has several optional dependency groups:

ADK Integration (Google Agent Development Kit):

pip install understudy[adk]

LLM Judges (litellm for 100+ provider support):

pip install understudy[judges]

All Extras:

pip install understudy[all]

Development (includes testing and documentation tools):

pip install understudy[dev]

Requirements

  • Python 3.12 or higher

  • pydantic >= 2.0

  • pyyaml >= 6.0

For LLM judges, you’ll need API keys for your chosen provider:

  • ANTHROPIC_API_KEY for Claude models

  • OPENAI_API_KEY for OpenAI models

  • GOOGLE_API_KEY for Gemini models

  • Or any other provider supported by litellm