How-to Guides and Examples

Headless Authentication (CI/CD)

For environments where interactive login isn't possible, use the PRUSA_TOKEN or PRUSA_TOKENS_JSON environment variables. See Authentication for full details.

Controlling a Printer

You can send commands like PAUSE, RESUME, or STOP.

from prusa.connect.client import PrusaConnectClient

client = PrusaConnectClient()

# Get your printer's UUID (e.g., from client.printers.list_printers())
printer_uuid = "c0ffee-uuid-1234"

# Pause the print
client.pause_print(printer_uuid)
print("Printer paused.")

Accessing Cameras

Fetch the latest snapshot from your printer's camera.

from prusa.connect.client import PrusaConnectClient

client = PrusaConnectClient()
cameras = client.cameras.list()

if cameras:
    cam = cameras[0]
    print(f"Taking snapshot from {cam.name}...")

    # Get binary image data
    image_data = client.get_snapshot(cam.id)

    with open("snapshot.jpg", "wb") as f:
        f.write(image_data)
    print("Saved to snapshot.jpg")

Managing Files

List files on your team's storage.

from prusa.connect.client import PrusaConnectClient

client = PrusaConnectClient()
teams = client.teams.list_teams()
if teams:
    my_team_id = teams[0].id
    files = client.files.list(my_team_id)

    for file in files:
        print(f"{file.name} ({file.size.human_readable() if file.size else 'N/A'})")