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

# Python SDK reference

> Complete generated reference for the public Valkyrie Python SDK.

This reference follows the tested `valkyrie.sdk` public contract. Internal models and helpers are excluded.

## Client

Use [`ValkyrieClient`](/reference/sdk/client) to configure the async client and access resource namespaces.

## Resource namespaces

<CardGroup cols={2}>
  <Card title="Runs" icon="play" href="/reference/sdk/runs">
    12 methods for starting, inspecting, streaming, controlling, and retrying runs.
  </Card>

  <Card title="Benchmarks" icon="flask" href="/reference/sdk/benchmarks">
    5 methods for retrieving benchmark status, tasks, and artifacts.
  </Card>

  <Card title="Agents" icon="robot" href="/reference/sdk/agents">
    2 methods for listing agents and retrieving bundle download URLs.
  </Card>

  <Card title="Benchmark services" icon="server" href="/reference/sdk/services">
    3 methods for discovering service catalogs, deployments, and task IDs.
  </Card>
</CardGroup>

## Types and errors

Browse [public models and enums](/reference/sdk/models) or the [SDK error hierarchy](/reference/sdk/errors).