Waidrin is a purpose-built role-playing game engine powered by an LLM. It is designed around an asynchronous, fully typed, fully validating state machine that uses constrained generation based on JSON schemas to dynamically create locations and characters as the story progresses, and keep track of them. Waidrin produces structured narrative events, not just chat messages. It can handle potentially thousands of characters and locations, without ever losing sight of what is happening.

While the engine itself is headless and can power any frontend, Waidrin comes with its own beautiful React-based frontend that is co-evolving with the engine to drive development forward. The frontend features AI-generated artwork that adds flavor and atmosphere to text-first storytelling.

At each turn, the player is presented with a choice of multiple AI-suggested actions, but they can also provide a different action as freeform text. This blends a classic CYOA experience with the limitless freedom of generative AI. It's an RPG unlike any other.

Note that only the fantasy genre is currently implemented.

The system generates a suitable character name and biography from the player's base choices. The player has the option to override those generated attributes.

Make sure you have Git and Node.js installed, then run the following commands:

git clone https://github.com/p-e-w/waidrin.git
cd waidrin
npm install
npm run build

Waidrin now uses Pollinations AI for free access to various AI models through their OpenAI-compatible API. No local setup or API keys are required!

Simply run:

npm run start

from Waidrin's installation directory, open the displayed URL in the browser, and follow the instructions. The application will connect to Pollinations AI automatically.

You can also use:

npm run dev

to run in development mode, which gives you features like hot reload and React Strict Mode, and is probably what you want if you plan to work on Waidrin's code (which you are very welcome to do!).

The application supports multiple AI models through Pollinations AI:

• Mistral Small 3.1 24B (recommended for RPG storytelling)
• DeepSeek V3 (advanced reasoning capabilities)
• OpenAI GPT-4o Mini (balanced performance)
• Qwen 2.5 Coder 32B (code-focused model)

You can select your preferred model during the initial setup or change it later in the connection settings.

Copyright © 2025 Philipp Emanuel Weidmann (pew@worldwidemann.com)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

By contributing to this project, you agree to release your contributions under the same license.