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

# Run Python

> Submit Python code to Lyceum Cloud from the CLI or REST API

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

## CLI

```bash theme={null}
lyceum python run "print('hello from lyceum')" --machine cpu
```

Run a file with a `requirements.txt`:

```bash theme={null}
lyceum python run script.py --machine gpu.a100 --requirements requirements.txt
```

## REST API

```bash theme={null}
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

```bash theme={null}
# 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"
```

```bash theme={null}
# Get just the logs
curl https://api.lyceum.technology/api/v2/external/logs/execution/<execution_id> \
  -H "Authorization: Bearer $LYCEUM_API_KEY"
```