> ## 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 learning-commons-evaluators Python package with pip, then run the Grade Level Appropriateness evaluator and print its grade band.

The Python SDK lets you use evaluators in your own project:

* Configure and run evaluators
* Understand their outputs
* Customize logging and handle errors

> [!NOTE]
>
> [Contact us](mailto:support@learningcommons.org) ↗ to request additional
> SDK language support. You can also [sign up for a Platform
> account](http://platform.learningcommons.org/) ↗ to receive updates on
> availability.

## 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

> [card] [Supported evaluators](https://docs.learningcommons.org/evaluators/using-evaluators/python-sdk/supported-evaluators.md)
>
> See which evaluators the Python SDK includes, and which API keys they need.

> [card] [Configuration](https://docs.learningcommons.org/evaluators/using-evaluators/python-sdk/configuration.md)
>
> Configure evaluators, including API keys and options.

> [card] [Evaluation](https://docs.learningcommons.org/evaluators/using-evaluators/python-sdk/evaluation.md)
>
> Understand evaluator input and output fields.

> [card] [Error handling](https://docs.learningcommons.org/evaluators/using-evaluators/python-sdk/error-handling.md)
>
> Handle configuration, validation, and API errors.