# Evaluation Suites
source: https://docs.chalk.ai/docs/evaluations/suites

## Group evaluations and their runs into named suites, and list what a suite holds.

A suite is a named collection of evaluations and their runs, such as a release
gate, a regression set, or one team's work.

Suite names are unique in an environment, and EvaluationSuite.create raises
EvaluationError for a name that is already taken. To reuse a suite across runs
of the same script, look it up by name and create it only when it is missing:

```
import chalkcompute

suites = chalkcompute.EvaluationSuite.list_all()
suite = next((s for s in suites if s.name == "Release"), None) or chalkcompute.EvaluationSuite.create(
    "Release"
)

for existing in suites:
    print(existing.id, existing.name)

for evaluation in suite.evaluations(limit=20):
    print(evaluation.name)

for run in suite.runs(limit=20):
    print(run.id, run.status)
```

suite.evaluations() and suite.runs() both yield newest first and page
transparently.