Skip to main content
The Valkyrie SDK is an async Python client for starting and inspecting runs from your own code. It needs Python 3.12 or later, and uses the same login and Tracker as the Valkyrie CLI.

Install

With uv installed and a Python 3.12+ virtual environment activated:
The SDK doesn’t install the CLI. Sign in once with 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 from ValkyrieSDKError. Catch ValkyrieAPIError when you need the HTTP status or the Tracker’s error detail:
The errors reference lists every exception.

Run the example scripts

The repository has two complete scripts. Run them from a Valkyrie checkout:

Next steps