Skip to content
Home
GitHub

Perstack Documentation

Perstack Architecture

Perstack is a containerized harness for agentic apps.

  • Harness = Runtime + Config — Instructions, agent topology, and tools are defined in TOML — not wired in code. The runtime executes what you declare in config.
  • Dev-to-prod in one container — Same image, same sandbox, same behavior from local to production.
  • Full observability — Trace every delegation, token, and reasoning step. Replay any run from checkpoints.

Perstack draws clear boundaries — between your app and the harness, between the harness and each agent — so you can keep building without fighting the mess.

  • Getting Started — create your first expert and walk through the core workflow
  • Concepts — understand the architecture behind experts, runtime, isolation, and the boundary model
  • Hard Signals — the design philosophy behind output quality — why hard verification signals make agents reliable
  • Skills — MCP tool integration and skill configuration
  • Base Skill — built-in tools available to all experts
  • Guides — task-oriented walkthroughs from rapid prototyping to production deployment
  • Deployment — container images, serverless integration, and perstack install
  • Isolation & Security — sandbox design, workspace boundaries, and secret management