---
title: Quickstart
description: 'This guide shows how to start a Studio, run a job, and stop it.'
canonical: 'https://lightning.ai/docs/sdk/stable/quickstart'
---
# Quickstart {#quickstart}

This guide shows how to start a Studio, run a job, and stop it.

## Start a Studio {#start-a-studio}

```python
from lightning_sdk import Studio

studio = Studio("my-studio")
studio.start()
```

## Run a command {#run-a-command}

Use [`run`](/docs/sdk/2026.11.04/api/studio.md#lightning_sdk.Studio.run) to execute a shell command inside the Studio:

```python
result = studio.run("echo 'Hello from Lightning!'")
print(result)
```

## Run a job on a GPU machine {#run-a-job-on-a-gpu-machine}

Pass a [`Machine`](/docs/sdk/2026.11.04/api/machine.md#lightning_sdk.Machine) to run on accelerated hardware:

```python
from lightning_sdk import Studio, Machine

studio = Studio("my-studio")
job = studio.run("python train.py", machine=Machine.A10G)
job.wait()
```

## Submit a named job {#submit-a-named-job}

Use [`lightning_sdk.Job.run`](/docs/sdk/2026.11.04/api/job.md#lightning_sdk.Job.run) when you want to submit a named async job directly:

```python
from lightning_sdk import Job, Machine

job = Job.run(
    name="train-model",
    command="python train.py",
    machine=Machine.A10G,
    studio="my-studio",
)
job.wait()
```

## Submit multi-machine training {#submit-multi-machine-training}

Use [`lightning_sdk.MMT.run`](/docs/sdk/2026.11.04/api/mmt.md#lightning_sdk.MMT.run) for distributed training across multiple machines:

```python
from lightning_sdk import MMT, Machine

mmt = MMT.run(
    name="distributed-train",
    command="python train.py",
    num_machines=4,
    machine=Machine.A10G,
    studio="my-studio",
)
mmt.wait()
```

## Stop the Studio {#stop-the-studio}

```python
studio.stop()
```

## Next Steps {#next-steps}

- See the [API Reference](/docs/sdk/2026.11.04/api.md) for the full public API.
- Explore multi-machine training with [`lightning_sdk.MMT.run`](/docs/sdk/2026.11.04/api/mmt.md#lightning_sdk.MMT.run).
- Deploy a model with [`Deployment`](/docs/sdk/2026.11.04/api/deployment.md#lightning_sdk.Deployment).

---

**Navigation**

- Parent: [Lightning SDK](/docs/sdk/2026.11.04.md)