Developers
Matilda is a single Python process: FastAPI on Uvicorn, SQLite for state, and the Strands Agents SDK driving a Kimi model. There is no JavaScript build step. Every page is rendered on the server.
| Page | What it covers |
|---|---|
| Architecture | Process layout, modules, request flow |
| Local development | Running from source and in Docker |
| Configuration | Every environment variable |
| Data model | Every SQLite table |
| The agent | Prompt, tools, turn pipeline, qualification, memory, scheduler |
| API reference | Webhook, worker, customer session, and dashboard endpoints |
| Testing | The test suite and the seeder |
The source lives in the ShafiqCo/matilda-webapp repository. The companion macOS worker lives in ShafiqCo/matilda-worker.