Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stacyide.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
StacyVM

StacyVM gives your applications disposable execution environments for AI agents, code runners, browser previews, and automation workflows. You keep control of the runtime, network, credentials, and audit trail while developers get a simple API and SDK.

What is StacyVM?

Understand the product, use cases, advantages, and where it fits.

Developer onboarding

Run one command, verify the server, execute code, and clean up.

Prerequisites

Check the host, runtime, CLI, SDK, and production requirements before you start.

Quickstart

Start a local server, create a sandbox, run code, and destroy it.

Architecture

See the control plane, scheduler, workers, providers, store, and sandbox lifecycle.

Example applications

Build Python and TypeScript services that run code inside StacyVM.

Python SDK

Use StacyVM from Python services, jobs, and agent frameworks.

TypeScript SDK

Use StacyVM from Node.js, web backends, and TypeScript agents.

​
What You Can Build

  • Run untrusted or generated code in short-lived sandboxes.
  • Give coding agents a filesystem, shell, and live preview URL without exposing your host.
  • Route sandbox work across Docker, Firecracker, PRoot, local providers, or remote workers.
  • Track quotas, audit events, runtime health, and production readiness evidence.
  • Integrate through REST, Python, or TypeScript.

​
First Sandbox

curl -sS -X POST http://localhost:7423/api/v1/sandboxes \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_test_YOUR_API_KEY" \
  -d '{"image":"python:3.12","ttl":"10m"}'
1

Install StacyVM

Start with developer onboarding, or review prerequisites if your host needs setup.
2

Run the quickstart

Use the quickstart to validate spawn, exec, files, and cleanup.
3

Pick an integration

Choose the Python SDK, TypeScript SDK, or REST API.
4

Prepare production

Use the deployment guide, support matrix, and runtime certification before making public runtime claims.
For public deployments, only claim support for runtimes you have certified on the target host.