INTRODUCTION
Podyard — millisecond sandboxes for AI agents. Unlimited pods, every run replayable, open source.
INTRODUCTION
Podyard is a hosted platform for running untrusted code in millisecond sandboxes — built for AI agents that need a real, isolated place to execute.
- Millisecond cold starts — pods boot in milliseconds on Apple M-series hardware.
- Unlimited pods — each plan has generous concurrency; pods sleep when idle and wake on demand.
- Every run replayable — snapshot a pod's state at any point, fork it into a new branch, and replay traces.
- Open source — Podyard is an independent hosted service on top of the open-source sandbox engine (Apache-2.0).
WHAT_PODYARD_GIVES_YOU
| Verb | What it does |
|---|---|
create | Boot a pod from a template in milliseconds. |
exec | Run a command inside the pod; stream stdout/stderr live (NDJSON). |
fs | Read and write files inside the pod's virtual filesystem. |
snapshot | Capture the pod's full state (filesystem + processes). |
fork | Branch a running pod or a snapshot into a new pod. |
destroy | Tear the pod down, releasing its resources. |
The Podyard API maps 1:1 onto the engine's verbs — we don't invent operations the engine doesn't deliver. Where the engine has gaps (e.g., directory listing over HTTP), we return honest errors and label the feature Coming soon.
ACCESS
Podyard is accessed three ways, all backed by the same API:
- REST API —
https://api.podyard.dev/v1/..., Bearer-authenticated withpyd_live_…/pyd_test_…keys. - TypeScript SDK —
npm i @podyard/sdk. - CLI —
npm i -g podyard, thenpodyard pods create.
Get a key in the dashboard, export it as PODYARD_API_KEY, and you're ready — see the Quickstart.
WHERE_TO_GO_NEXT
- Quickstart — 60 seconds to a running pod.
- Concepts — pods, sessions, snapshots, limits, security.
- API reference — every endpoint, generated from the OpenAPI spec.
- Pricing & limits — plans and per-plan limits, from a single source of truth.