SmolVM

1. Install Celesto

On Linux or macOS, this command installs the Celesto CLI and Python SDK, prepares the machine, and checks that it is ready:

curl -fsSL https://celesto.ai/install.sh | bash

<details> <summary>Manual local setup</summary>

Install Celesto with Python 3.11 or newer, prepare the machine, then check the setup:

pip install celesto
celesto setup
celesto doctor

On macOS, setup uses Homebrew to install QEMU. On Linux, setup may ask for sudo.

</details>

Start cloud computers with your packages installed

A custom template is a built-in template plus your own setup commands. Celesto runs the commands once and saves the result, so every cloud computer you create from the template starts with your packages ready:

from celesto import Template

template = Template.create(
    name="data-env",
    build_script="apt-get install -y ffmpeg\npip install pandas",
)
template.wait(on_log=print)  # prints the build log; returns when the build is ready

with template.create_computer() as computer:
    print(computer.run("ffmpeg -version").stdout)

The build script runs once, as root, and stops at the first failing command. Files can't be uploaded with it, so list packages directly instead of using pip install -r requirements.txt. Check a script first with Template.lint(script), load a template with Template.get("tpl_..."), or pass its ID as CloudComputer(template_id="tpl_..."). See the custom templates guide for limits, errors, and rebuilding.

Quickstart

Examples

Use the Python API

The installer includes the Python SDK. The with block creates a local computer when the block starts and deletes it when the block ends:

from celesto import Computer

with Computer() as computer:
    result = computer.run("echo 'Hello from Celesto!'")
    print(result.stdout)

Common workflows

Agent framework integrations

Each example includes any extra package command it requires.