Tutorials and application guides

The canonical tutorial grows one ticket desk. Each chapter provides the files to write and tests to run against the same application. Start there if you are new to Aksara.

Chapter	Application behavior
First project	Models, migrations, protected REST and tests
Relations and validation	Agent assignment and input validation
Tenant isolation	Customer membership, permissions and PostgreSQL RLS
Background reports	Queued reports with protected CSV download
Durable actions	Idempotency, workers, retry, cancellation and current authorization
Optional MCP client	Synchronous tool execution with the official client

The tutorial uses Python 3.11–3.14 and PostgreSQL. The installation guide covers setup. The production guide covers deployment responsibilities after the application works locally; it is a how-to, not another starter application.

Other examples

Blog API and multi-tenant application are separate examples, not continuations of the ticket desk. Consult their scope notes before combining their snippets with an existing application. AI integration concerns optional experimental features.

The example catalog describes the repository's sample applications and known limitations. No separate examples repository is required for the ticket desk: its source and tests are included in the chapters.