Skip to content

Documentation

New here? Start with Core Concepts, then Getting Started.

Using TheAct

Document Description
Getting Started Install, configure, play your first game (CLI and Web UI)
Creating a Game Write game YAML files or use the creator agent

Understanding the System

Document Description
Core Concepts Key terms and how the system works at a high level
Architecture Turn pipeline, module map, concurrency, streaming
Data Model Game files, save files, Pydantic models
Agents Agent roles, prompt design, structured output
Memory & Summarization Character memory, rolling summary, context budgeting

Development & Debugging

Document Description
Observability Call logging, diagnostics, error taxonomy, profiler
Debugging Turn debugger and troubleshooting
Playtesting Autonomous playtest framework, golden scenarios
Prompt Engineering Prompt iteration, A/B testing, model quirks

Reference

Document Description
Save Versioning Git-based saves, forking, undo
Game Creation Pipeline Creator agent internals
Requirements & Rationale Why design decisions were made
Model Quirks Observed 7B model behaviors and workarounds
Phase Plans Step-by-step implementation plans (01-13)