Choose computer size

You can choose how much CPU, memory, and storage a Celesto computer gets before it starts. Start with the default size for small jobs, then choose more resources when your agent builds code, installs packages, opens large files, or runs a web app.

Start with a template

A template is a ready-made starting setup for a computer. It includes an operating system, useful tools, and default resource sizes. Use coding-agent when your workflow needs common coding tools. Use the template defaults when you are running quick scripts or trying Celesto for the first time.

from celesto import Celesto


client = Celesto()
templates = client.computers.list_templates()

for template in templates:
    print(
        f"{template['id']}: "
        f"{template['default_vcpus']} CPU, "
        f"{template['default_ram_mb']} MB memory"
    )

Choose what to change

Change one setting at a time when the default size is too small. MB means megabytes, a common unit for memory and disk size.

cpus

integer

CPU cores for the computer. CPU cores run code and build commands. Range: 1-16.

memory

integer

Working space for running programs. More memory helps with notebooks, large files, package installs, and heavier services. Range: 512-32768 MB.

disk_size_mb

integer

File storage inside the computer. More disk space helps with repositories, build output, downloaded files, and generated artifacts. Range: 512-51200 MB.

template_id

string

default:"scratch"

Ready-made starting setup for the computer. Use coding-agent when your agent needs coding tools already installed.

Create a larger computer

Create a larger computer when the default template does not have enough room for the job. This example creates a coding-agent computer with 2 CPUs, 4096 MB of memory, and 20480 MB of disk space.

from celesto import Celesto


client = Celesto()
computer = client.computers.create(
    template_id="coding-agent",
    cpus=2,
    memory=4096,
    disk_size_mb=20480,
)

print(computer["name"])
print(f"{computer['vcpus']} CPU")
print(f"{computer['ram_mb']} MB memory")
print(f"{computer['disk_size_mb']} MB disk")

client.computers.delete(computer["id"])

The response shows the CPU, memory, and disk size assigned to the new computer.

Pick a starting size

Use the smallest computer that can finish the job. Increase the setting that matches the problem you see.

Workload	Start with
Quick shell commands	Template defaults
Coding agent with package installs	`coding-agent`, 2 CPUs, 4096 MB memory
Large repository builds	More CPU and disk
Data processing or notebooks	More memory and disk
Hosted preview app	Enough memory for the app, plus port publishing

Increase CPU for slow builds, memory for programs that crash or slow down under load, and disk size when the computer runs out of file storage.

​Start with a template

​Choose what to change

​Create a larger computer

​Pick a starting size

Start with a template

Choose what to change

Create a larger computer

Pick a starting size