---
title: "Guides"
description: "Task-oriented How-To guides for getting things done with Freestyle."
url: "/docs/guides"
---

Guides are short, task-oriented recipes — each one walks through a single "How do I…"
end to end. For complete API and concept reference, see the [Docs](https://www.freestyle.sh/docs).

Guides are primarily made for AI Agents, they are written for clarity over conciseness and include more case-specific details than docs for humans do. They are oriented towards helping agents follow paths we know work, and knowing how to avoid/handle sharp edges. 

For humans, we recommend chatting with an agent about them rather than reading them top to bottom. 

- [How to Run Claude Code in a Sandbox](https://www.freestyle.sh/docs/guides/run-claude-code-in-a-sandbox): Bake Claude Code into a VM snapshot, then run it over PTY, one-off prompts, or the Claude Agent SDK.
- [How to Run Node.js in a Sandbox](https://www.freestyle.sh/docs/guides/run-nodejs-in-a-sandbox): Bake Node.js into a VM snapshot, then run JavaScript snippets on one sandbox VM.
- [How to Run Bun in a Sandbox](https://www.freestyle.sh/docs/guides/run-bun-in-a-sandbox): Bake Bun into a VM snapshot, then run TypeScript and JavaScript on one sandbox VM.
- [How to Run Python in a Sandbox](https://www.freestyle.sh/docs/guides/run-python-in-a-sandbox): Build a reusable VM snapshot with Python, then run many scripts on one long-lived, isolated sandbox VM.
- [How to Give Your OpenAI Agent a Sandbox](https://www.freestyle.sh/docs/guides/give-your-openai-agent-a-sandbox): Give an OpenAI Agents SDK agent a fresh Linux VM by implementing SandboxClient.
- [How to Run Chromium in a Sandbox](https://www.freestyle.sh/docs/guides/run-chromium-and-chrome-in-a-sandbox): Run Chrome-family browsers headless or headed, connect over CDP, watch through noVNC, and give a computer-use agent control.
- [How to Give Your Mastra Agent a Sandbox](https://www.freestyle.sh/docs/guides/give-your-mastra-agent-a-sandbox): Give a Mastra agent a fresh Linux VM by implementing Mastra's Workspace sandbox interface.
- [How to Run Docker in a Sandbox](https://www.freestyle.sh/docs/guides/run-docker-in-a-sandbox): Bake Docker into a VM snapshot, then boot sandboxes that run containers and Docker Compose stacks.
- [How to Run OpenClaw in a Sandbox](https://www.freestyle.sh/docs/guides/run-openclaw-in-a-sandbox): Run OpenClaw in a VM snapshot and open its web UI.
- [How to Run VS Code in the Browser in a Sandbox](https://www.freestyle.sh/docs/guides/run-vs-code-in-a-sandbox): Bake code-server into a VM snapshot, then open VS Code in the browser.
- [How to Run Android in a Sandbox](https://www.freestyle.sh/docs/guides/run-android-in-a-sandbox): Build a reusable Android 15 emulator image, watch it through noVNC, and give a computer-use agent control through adb.
- [How to Run GitHub Copilot in a Sandbox](https://www.freestyle.sh/docs/guides/run-github-copilot-in-a-sandbox): Run the GitHub Copilot CLI headless in a sandbox and drive it over a private VPC or WireGuard VPN.
- [How to Run a Web Terminal in a Sandbox](https://www.freestyle.sh/docs/guides/run-a-web-terminal-in-a-sandbox): Stream a VM's PTY to the browser with xterm.js or ttyd.
- [How to Run a Jupyter Notebook Server in a Sandbox](https://www.freestyle.sh/docs/guides/run-jupyter-in-a-sandbox): Bake JupyterLab into a VM snapshot, then open the notebook on a public domain.
- [How to Run a Vite Dev Server in a Sandbox](https://www.freestyle.sh/docs/guides/run-vite-in-a-sandbox): Bake a Vite dev server into a VM snapshot, run it under systemd, and open it on a public domain.
- [How to Run a Next.js Dev Server in a Sandbox](https://www.freestyle.sh/docs/guides/run-nextjs-in-a-sandbox): Bake a Next.js dev server into a VM snapshot, run it under systemd, and open it on a public domain.
- [How to Run Postgres in a Sandbox](https://www.freestyle.sh/docs/guides/run-postgres-in-a-sandbox): Bake PostgreSQL into a VM snapshot, then boot a VM and run SQL queries.
- [How to Run Supabase in a Sandbox](https://www.freestyle.sh/docs/guides/run-supabase-in-a-sandbox): Run the Supabase stack in a Docker-backed VM and reach its APIs on a public domain.
- [How to Run Convex in a Sandbox](https://www.freestyle.sh/docs/guides/run-convex-in-a-sandbox): Run the self-hosted Convex backend in a Docker-backed VM and connect a Convex project to it.
- [How to Run InstantDB in a Sandbox](https://www.freestyle.sh/docs/guides/run-instantdb-in-a-sandbox): Run InstantDB's self-hosting stack in a Docker-backed VM and expose its sync engine on a public domain.
- [How to Run Hasura in a Sandbox](https://www.freestyle.sh/docs/guides/run-hasura-in-a-sandbox): Run Hasura and Postgres in a VM, then open the Console on a public domain.
- [How to Run MongoDB in a Sandbox](https://www.freestyle.sh/docs/guides/run-mongodb-in-a-sandbox): Bake MongoDB into a VM snapshot, then run document queries with no startup wait.
- [How to Run Redis in a Sandbox](https://www.freestyle.sh/docs/guides/run-redis-in-a-sandbox): Bake Redis into a VM snapshot, then boot sandboxes with a ready key-value store.
- [How to Run Python with uv in a Sandbox](https://www.freestyle.sh/docs/guides/run-python-with-uv-in-a-sandbox): Bake uv into a VM snapshot, then reuse one sandbox to run many Python scripts with a small helper.
- [How to Run Deno in a Sandbox](https://www.freestyle.sh/docs/guides/run-deno-in-a-sandbox): Bake Deno into a VM snapshot, then run TypeScript snippets or serve HTTP from the same sandbox.
- [How to Run Go in a Sandbox](https://www.freestyle.sh/docs/guides/run-go-in-a-sandbox): Bake Go into a VM snapshot, then run Go programs on one sandbox VM.
- [How to Run Java in a Sandbox](https://www.freestyle.sh/docs/guides/run-java-in-a-sandbox): Bake the JDK into a VM snapshot, then run Java programs and serve HTTP from the same sandbox.
- [How to Run Ruby in a Sandbox](https://www.freestyle.sh/docs/guides/run-ruby-in-a-sandbox): Bake Ruby into a VM snapshot, then run Ruby scripts on one sandbox VM.
- [How to Run PHP in a Sandbox](https://www.freestyle.sh/docs/guides/run-php-in-a-sandbox): Bake PHP into a VM snapshot, then run scripts and serve PHP from the same sandbox.
- [How to Run Iron Proxy on a Router VM](https://www.freestyle.sh/docs/guides/run-iron-proxy-on-a-router-vm): Route a VM through a router VM that runs iron-proxy, then configure the client VM to use that proxy by default.
- [How to Run Hexclave in a Sandbox](https://www.freestyle.sh/docs/guides/run-hexclave-in-a-sandbox): Run Hexclave in a Docker-backed VM and open its API and dashboard on a public domain.
- [How to Run GNOME in a Sandbox](https://www.freestyle.sh/docs/guides/run-gnome-in-a-sandbox): Build a GNOME desktop with TigerVNC, Chromium, and noVNC, then snapshot and reuse it.
- [How to Stream Audio Alongside noVNC](https://www.freestyle.sh/docs/guides/stream-audio-with-vnc-in-a-sandbox): Add browser audio to a noVNC desktop with a PulseAudio null sink and a sidecar WebM/Opus stream served from the same VM.