Get started with the Celesto SDK

Before you start

Get an API key from celesto.ai under Settings > Security. Set it as CELESTO_API_KEY before you run the examples.

Install the Python SDK

pip install -U celesto

Run your first computer

Create quickstart.py:

quickstart.py

import os

from celesto import Computer


if not os.environ.get("CELESTO_API_KEY"):
    raise RuntimeError("Set CELESTO_API_KEY before running this script.")

computer = Computer(template_id="scratch")
print(f"Computer ready: {computer.name}")

result = computer.run("uname -a")
print(result["stdout"].strip())

computer.delete()

Run it:

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

The script prints the computer name, prints Linux system information, and deletes the computer.

Next step

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

Start Here

Core Ideas

Popular Paths

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