Run Python - Lyceum Documentation

The simplest workflow: submit a Python snippet, get back an execution_id, fetch the result.

CLI

lyceum python run "print('hello from lyceum')" --machine cpu

Run a file with a requirements.txt:

lyceum python run script.py --machine gpu.a100 --requirements requirements.txt

REST API

curl -X POST https://api.lyceum.technology/api/v2/external/execution/streaming/start \
  -H "Authorization: Bearer $LYCEUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "print(1 + 1)",
    "machine_type": "cpu"
  }'

The response includes an execution_id and a streaming URL for live output.

Fetching results

# Get the full execution record (status, stdout, stderr, result)
curl https://api.lyceum.technology/api/v2/external/execution/<execution_id> \
  -H "Authorization: Bearer $LYCEUM_API_KEY"

# Get just the logs
curl https://api.lyceum.technology/api/v2/external/logs/execution/<execution_id> \
  -H "Authorization: Bearer $LYCEUM_API_KEY"