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

### Archive a suite

Use suite.archive() or EvaluationClient.archive_suite(suite_id) to hide a suite
and its evaluations and runs from lists. Datasets are preserved. Archiving does
not cancel running work or change each evaluation's or run's independent archive
state. Direct evaluation and run ID lookups remain available.

```
archived_suite = suite.archive()
print(archived_suite.archived_at)
```

From the CLI, run chalk eval suite archive <suite-id>. In the dashboard, choose
Archive from the suite row's three-dot menu or the suite detail page. The
confirmation explains that the suite's evaluations and runs will also be hidden.

Repeated archival succeeds. The built-in Default suite cannot be archived.
Archived suite names remain reserved, and you cannot create or move evaluations
into an archived suite. Unarchiving is not supported.





