Skip to main content
This book takes you from nothing to a production integration: an AI agent that can act on a real system only when a policy and a person allow it, with a signed record of every decision. It is the companion to The Parmana Handbook, which explains how each part of Parmana is built. This book explains how to build with it. Download it as one PDF: build-with-parmana.pdf.

​
Who it is for

​
How the book is written

  • Every statement is checked against the code. Where the book and the code disagree, the code wins and the book is fixed. Anything not verified in production says so.
  • The reference chapters are generated from the code. Every endpoint, every SDK method and every error code are produced by scripts/generate-build-book-reference.ts from the OpenAPI file, the SDK source and the server’s error classes. A test fails when they fall behind the code.
  • Examples are real. Responses are captured from the running server; tutorial output is what the tutorial prints.
  • Procedures state what to expect. Where a step can fail, it says what you see and what to do.

​
The chapters

  1. How Parmana works: one request, from an agent to a signed record.
  2. Your first governed action: run it on your machine in minutes.
  3. Connect an agent: the request, the policy in effect, approvals, in both SDKs.
  4. Policies: write one, get it approved, change it, roll it back.
  5. Human approvals: approvers, signing, and what an approval covers.
  6. Connect your systems: built in connectors and external connectors.
  7. Verify and audit: records you can check without trusting the server.
  8. Deploy and operate: production, keys, migrations, monitoring.
  9. Errors and troubleshooting: what each answer means and what to do.
  10. Security model and limits: what is guaranteed, and what is not.
Reference: every endpoint, every SDK method, every error code.

​
Versions

This edition describes the code on main as of 2026-10-01. The published SDKs are 1.4.0 (@parmana/sdk on npm, parmana on PyPI). Methods marked next release are in the repository and not yet published: policyInEffect and policy_in_effect, verifyParmanaRelease and verify_parmana_release.