Install
With uv installed and a Python 3.12+ virtual environment activated:valkyrie login,
or set VALKYRIE_API_KEY to an access key.
List your runs
ValkyrieClient() sends requests to the Tracker you last signed in to. To pick the Tracker
or access key in code, see Configure the Python SDK.
Handle errors
Every SDK exception inherits fromValkyrieSDKError. Catch ValkyrieAPIError when you
need the HTTP status or the Tracker’s error detail:
Run the example scripts
The repository has two complete scripts. Run them from a Valkyrie checkout:Next steps
- Manage runs with Python to start, watch, recover, and download runs
- Inspect resources with Python for tasks, logs, agents, secrets, and services
- Python SDK reference for every method, model, and field

