Skip to Content
Podyard

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

VerbWhat it does
createBoot a pod from a template in milliseconds.
execRun a command inside the pod; stream stdout/stderr live (NDJSON).
fsRead and write files inside the pod's virtual filesystem.
snapshotCapture the pod's full state (filesystem + processes).
forkBranch a running pod or a snapshot into a new pod.
destroyTear 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 with pyd_live_… / pyd_test_… keys.
  • TypeScript SDK — npm i @podyard/sdk.
  • CLI — npm i -g podyard, then podyard 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.