Actant documentation

Actant is a Temporal-native runtime for persistent agents. Start with the concepts before copying the production wiring: the important distinction is that Actant models a durable thread, not a single model invocation.

Start here

1. Why Actant? — the problem Actant removes, its runtime guarantees, and how it differs from adjacent agent frameworks.
2. Core concepts — the vocabulary and ownership boundaries.
3. Runtime architecture — the exact workflow algorithm, activity contracts, state ownership, and recommended code-reading order.
4. Runtime guide — connect a client and run a worker.
5. Tools guide — tool schemas, execution, and admission.
6. Pauses and deferred work — approval and durable wait semantics.
7. Subagents — synchronous and durable delegation.
8. Coordinator guide — application policy for multi-agent products.
9. Release checklist — validate, version, and publish the wheel through GitHub's trusted PyPI workflow.

Learn from a running system

The demo combines FastAPI, Postgres, Temporal, and a React viewer. Its deterministic model exercises streaming, approvals, multiple-choice input, and nested delegation without an API key.

just demo-sync
just demo

Open http://localhost:5173 after the services start.

Documentation boundaries

• These guides describe Actant's public runtime concepts and extension points.
• The Python modules remain the source of truth for exact signatures while the package is pre-1.0.
• Product concerns such as authentication, tenancy, HTTP APIs, artifact storage, and UI state deliberately remain outside the kernel.