Quickstart

Create a Thunder sandbox and run your first command with the Python SDK.

Create your first sandbox by installing the Python SDK and running a short script.

1. Install and authenticate the Python SDK

Install the Thunder Sandbox SDK, then sign in with the Thunder CLI. The SDK automatically uses the credentials saved by the CLI.

pip install thunder-sandbox
tnr login

2. Run code in a sandbox

Create a file named get_started.py with the following code:

get_started.py

import thunder

sandbox = thunder.Sandbox.create(cpu=4, memory=32, storage=50)
sandbox.wait_until_running()

process = sandbox.exec("uname", "-a")
print(process.stdout.read())
process.wait()

sandbox.terminate()

This script creates a sandbox, waits for it to start, runs uname -a, prints the command output, waits for the command to finish, and terminates the sandbox.

Run the script with Python:

python get_started.py

You have now run code in a Thunder sandbox. See the Sandbox API reference for details about every SDK function used in this example.