Skip to content

Judge Models and Authentication 👩‍⚖️🔑

Simpleval supports several judges, each one with its own authentication method. The way to authenticate with each judge is usually via environment variables or similar implicit methods. There might also be judge-specific details found below.

You can see how each judge type is authenticated below, but in short, most judges are based on Lite LLM, so you can always also refer to its documentation.

Tip

You can view supported model ids for Lite LLM judges by running:

1
simpleval litellm-models-explorer
Anthropic Judge

Required environment variable:

1
ANTHROPIC_API_KEY

Example:

1
ANTHROPIC_API_KEY=<your-key>

See the Anthropic docs for more details.

Azure Judge

Required environment variables:

1
2
3
AZURE_OPENAI_API_KEY
AZURE_API_VERSION
AZURE_API_BASE

Example:

1
2
3
AZURE_OPENAI_API_KEY=<your-key>
AZURE_API_VERSION=2024-04-01-preview
AZURE_API_BASE=https://<your_resource_name>.openai.azure.com/

Available Versions

You can see available versions in the Azure docs

Bedrock Claude Sonnet Judge

This judge is NOT based on Lite LLM, it is implemented natively with boto3 calling Bedrock.

Required credentials:

AWS credentials must be available, either via environment variables or in a ~/.aws/credentials file.

You can learn more about using AWS credentials in the AWS docs

Gemini Judge

Required environment variable:

1
GEMINI_API_KEY

See the Gemini API docs for more details.

Generic Bedrock Judge

Required credentials:

AWS credentials must be available, either via environment variables or in a ~/.aws/credentials file.

You can learn more about using AWS credentials in the AWS docs

LiteLLM Structured Output Judge

Required authentication:

Depends on the provider you use with LiteLLM.

You can learn about the available providers in the LiteLLM documentation.

And about structured output in LiteLLM here

OpenAI Judge

Required environment variable:

1
OPENAI_API_KEY

See the OpenAI API docs for more details.

Vertex AI Judge

Required environment variable:

1
2
3
GOOGLE_APPLICATION_CREDENTIALS
VERTEXAI_LOCATION
VERTEXAI_PROJECT

Example:

1
2
3
GOOGLE_APPLICATION_CREDENTIALS=/path/to/your/service-account-key.json
VERTEXAI_LOCATION=us-central1
VERTEXAI_PROJECT=your-project-id

See the Vertex AI docs for more details.