# Impello docs

> Impello runs isolated Linux sandboxes that an agent starts with one call,
> works in over the TypeScript or Python SDK, and pauses or kills when it is
> done. These are the product docs: the SDKs, the HTTP API, templates, the
> sandbox lifecycle, errors, and limits and pricing. Every page below is also
> available as Markdown by adding `.md` to its URL, and the whole set is at
> https://www.impello.ai/llms-full.txt

Last reviewed 2026-09-16.

## Getting started

- [Impello docs](https://www.impello.ai/docs): Install the TypeScript or Python SDK, start a sandbox, run a command in it, and find the page for every other task an agent needs.
- [Quickstart](https://www.impello.ai/docs/quickstart): Install the SDK, create a sandbox from the base template, run a command in it and shut it down, in TypeScript, Python or curl.
- [API keys](https://www.impello.ai/docs/api-keys): Create an API key, hand it to the SDK by environment variable or per call, rotate it safely, and set the other connection options.

## Templates

- [Templates](https://www.impello.ai/docs/templates): The default sandbox templates, what each one contains, how big it is, and how to pick one by name when you create a sandbox.
- [Build a custom template](https://www.impello.ai/docs/templates/build): Define a template from an image, a Dockerfile or a default template, give it a start command, build it, tag it and create sandboxes from it.

## Sandbox

- [Sandbox lifecycle](https://www.impello.ai/docs/sandbox): Create a sandbox with the right options, reconnect to it later, inspect and list your sandboxes, and kill them.
- [Run commands](https://www.impello.ai/docs/sandbox/commands): Run a shell command in a sandbox, stream its output, keep it running in the background, send it input and handle a non-zero exit.
- [Interactive terminal](https://www.impello.ai/docs/sandbox/pty): Open a pseudo-terminal in a sandbox, send it keystrokes, resize it, reconnect to it from another process and kill it.
- [Filesystem](https://www.impello.ai/docs/sandbox/filesystem): Read and write files in a sandbox, list and inspect directories, watch a directory for changes, and move data in and out over signed HTTP URLs.
- [Git](https://www.impello.ai/docs/sandbox/git): Clone a repository into a sandbox, authenticate against a git host, commit, push and pull, and inspect branches and status from the SDK.
- [Network and public URLs](https://www.impello.ai/docs/sandbox/network): Reach a sandbox port over HTTPS, restrict what the sandbox can call out to, require a token on the way in, and change the policy while the sandbox runs.
- [Pause, resume and snapshots](https://www.impello.ai/docs/sandbox/pause-and-snapshots): Pause a sandbox so it stops costing anything, resume it where it stopped, take named snapshots to start new sandboxes from, and fork a running sandbox in Python.
- [Metrics](https://www.impello.ai/docs/sandbox/metrics): Read CPU, memory and disk usage for a sandbox, narrow the result to a time range, and handle a template too old to report metrics.
- [Timeouts](https://www.impello.ai/docs/sandbox/timeouts): Set how long a sandbox lives, extend it while it runs, pause instead of kill when it expires, and tell the three timeouts apart.

## Reference

- [Errors](https://www.impello.ai/docs/errors): Every error class the SDKs throw, the HTTP status or RPC code that produces it, how a non-zero command exit surfaces, and which class to catch.
- [Limits and pricing](https://www.impello.ai/docs/limits-and-pricing): The three plans and their limits, what compute costs, how credit is granted and spent, how to cap your spend, and what credit running out does.
- [Migrate from E2B](https://www.impello.ai/docs/migrate-from-e2b): Swap the package, the API key and the environment variables to move an E2B integration to Impello, rebuild your templates, and see what is missing.