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]"

LangGraph Integration:

pip install "understudy[langgraph]"

LangChain create_agent Integration:

pip install "understudy[langchain]"

All Extras, including the CLI and reports:

pip install "understudy[all]"

LLM judges use LiteLLM, which is included in the base installation.

Development from a repository checkout:

uv sync --all-extras --all-groups

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