FAQ

How do I get started?

Install the SDK with pip install htsdk, grab your API key from the dashboard, and you're ready to launch VMs. Check out the Quick Start guide for a complete walkthrough.

How long do VMs stay alive?

By default, VMs auto-terminate after 5 minutes (300 seconds). You can customize this with the lifetime_seconds parameter when creating a node:

client.create_node(lifetime_seconds=1800)  # 30 minutes

What VM sizes are available?

Choose from three sizes:

SMALL – 1 vCPU, 1GB RAM
MEDIUM – 1 vCPU, 2GB RAM
LARGE – 2 vCPU, 4GB RAM

Specify with NodeSize enum: client.create_node(node_size=NodeSize.LARGE)

For more powerful compute options, please email heaptreehq@gmail.com.

Can I transfer files to and from VMs?

Use upload() to send files to your VM and download() to retrieve them:

# Upload a file
client.upload(node_id, file_path="./script.py")

# Download results
client.download(node_id, remote_path="/home/ubuntu/output.txt", local_path="./output.txt")

See the Upload and Download docs for details.

Which languages can I execute code in?

Python, JavaScript, TypeScript, and C++ via the Language enum:

from heaptree.enums import Language

client.run_code(node_id, lang=Language.PYTHON, code="print('Hello!')")

Why do commands fail immediately after creating a VM?

VMs need 30–60 seconds to fully boot. If you run commands too quickly, they may fail. Simply wait a moment after creation before executing commands.

How do I get help?

Email us at heaptreehq@gmail.com – we typically respond within a few hours.

FAQ