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

# Quickstart

> Install the Python SDK and run your first evaluator.

Install the Python SDK, then run an evaluator from your project.

## Install the SDK

| | Latest release |
| - | - |
| [GitHub](https://github.com/learning-commons-org/evaluators/tree/main/sdks/python#installation) ↗ | [![PyPI version](https://img.shields.io/pypi/v/learning-commons-evaluators)](https://pypi.org/project/learning-commons-evaluators) |

Install the SDK from the package registry rather than cloning the [evaluators repository](https://github.com/learning-commons-org/evaluators) ↗. The published package is versioned, so you can pick up fixes and new evaluators with a standard package update:

```bash theme={null}
pip install --upgrade learning-commons-evaluators
```

## Run an evaluator

```python theme={null}
from learning_commons_evaluators import GradeLevelAppropriatenessEvaluator

evaluator = GradeLevelAppropriatenessEvaluator(
  google_api_key="your-google-key",
)

result = evaluator.evaluate_sync(
  text="The cat's out of the bag now.",
).result

print(result.grade_band)  # e.g. 2-3
```

## Related topics

> **[Supported evaluators](/evaluators/sdk-api-reference/python/supported-evaluators)**
>
> See which evaluators the Python SDK includes, and which API keys they need.

> **[Configuration](/evaluators/sdk-api-reference/python/configuration)**
>
> Configure evaluators, including API keys and options.

> **[Evaluation](/evaluators/sdk-api-reference/python/evaluation)**
>
> Understand evaluator input and output fields.

> **[Error handling](/evaluators/sdk-api-reference/python/error-handling)**
>
> Handle configuration, validation, and API errors.