The AI Personas companion

These three local applications put selected ideas from the book into code. You can run them, read how they work and change them.

Download the three applications Source code on GitHub

You need Node.js 24 or later and your own model API key. The software is free under the MIT license. Your model provider may charge for use.

Persona

An authored character with shared memory. Its point of reference is a character you define and keep recognizable.

v0.5.0

Home Repair Advisor

A repair case with observations, evidence and a history of decisions. The case gives the conversation something concrete to return to.

v0.4.0

Mara

A continuing persona that records experience and permits bounded changes to habits and views. Its records let you inspect what changed.

v0.3.0

Run an application

Install Node.js 24 or later, download the ZIP and extract it.
Open the README in the application’s folder. Copy .env.example to .env there and configure your model provider and API key.
On macOS, use the application’s .command launcher; on Windows, use its .cmd launcher. You can also use the terminal commands below from the extracted folder.
Open the local address printed in the terminal. Keep the server bound to localhost.

npm run start:persona
npm run start:advisor
npm run start:mara

Each application includes an English README and a Brazilian Portuguese guide. The interfaces and conversations support both languages.

Install Node.js

Materials from the book

Teaching laboratory

The ZIP includes a memory example, database schemas, a persona specification and a write protocol. These small examples let you inspect a mechanism separately from a complete application.