Get started with the Celesto SDK

Install the Python SDK

python -m pip install --upgrade "celesto>=0.1.7"

Run your first computer

A named API key needs all three permissions for this example: See your computers, Create, start, stop computers and run commands, and Delete computers. The final permission lets the example clean up after itself.

The free trial allows one sandbox at a time, including stopped sandboxes. Reuse your existing sandbox, delete it when you are done, or add prepaid credit before creating another. HTTP 429 can mean this limit; waiting does not free the slot.

Create quickstart.py:

quickstart.py

from celesto import CloudComputer


with CloudComputer() as computer:
    print(f"Computer ready: {computer.id}")
    result = computer.run("uname -a")
    print(result.stdout.strip())
    if result.exit_code != 0:
        raise RuntimeError(f"Command failed: {result.stderr}")

Run it:

export CELESTO_API_KEY="your-api-key"
python quickstart.py

The script prints the computer ID and Linux system information. Exiting the with block deletes the computer, including when your code fails.

If creation fails, follow the error’s recovery message. If the response is unreadable or the connection times out, inspect your computers in the dashboard before creating another. See error handling for uncertain outcomes and cleanup failures.

Next step

Learn how to create computers with templates when your agent needs coding tools already installed.

Get started

Run code

Save and resume work

Connect your apps

Connect AI agents

Reference and troubleshooting

Get started with the Celesto SDK

Before you start

Install the Python SDK

Run your first computer

Next step

​Before you start

​Install the Python SDK

​Run your first computer

​Next step

Before you start

Install the Python SDK

Run your first computer

Next step