gitwtfhub

wtf is grimoire?

t0m13/grimoire — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · vibe coderComplexity · 4/5Setup · hard

TL;DR

A browser-based fantasy RPG where one host runs the game locally and an AI Dungeon Master narrates, voices, and illustrates the story as friends play together.

Mindmap

mindmap
  root((Grimoire))
    What it does
      AI Dungeon Master
      Voice narration
      Generated art
    Tech stack
      TypeScript
      Node.js
      WebSocket API
    Use cases
      Game night with friends
      Solo adventure
      Local hosting
    Audience
      Vibe coders
      Tabletop fans
    Setup
      Windows start script
      Linux shell scripts
      GPU recommended

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Host a fantasy tabletop-style game night for friends without anyone installing software.

REASON 2

Play a solo AI-narrated adventure with generated art, voice, and music.

REASON 3

Learn how a local-first AI game loop combines dice rules, narration, and image generation.

What's in the stack?

TypeScriptNode.jsWebSocket

How it stacks up

t0m13/grimoire0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardeasy
Complexity4/54/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Needs a modern NVIDIA GPU, several gigabytes of downloaded models, and at least 15GB free disk space for the smoothest experience.

Wtf does this do

Grimoire is a fantasy role-playing game that runs in your web browser. One person hosts the game on a Windows or Linux computer, and friends join the same adventure by opening a link, no installation needed on their side. You build a hero, explore places, talk with characters, and make choices that shape the story, and the game writes and speaks that story back to you with changing scene art, portraits, music, and sound effects. Character creation walks you through races, classes, abilities, backgrounds, skills, languages, and equipment based on the 2014 SRD tabletop rules, or you can hit Randomize Everything to jump straight into playing. Once you are in the world, you can type your own actions, speak directly to named characters, or pick from suggested choices. The game tracks relationships with characters over time and rolls dice checks when an action carries real risk. A character sheet, map, quest list, and settings panel sit alongside the story so you can check details without losing your place. Multiplayer works as one shared journey per host: everyone sees the same location, story, and dice results, and the game resolves one action at a time rather than using a fixed turn order. Private side conversations and parallel activities are planned but not built yet, so treat this as a shared campaign in one room for now. Setup on Windows uses a start script that installs the needed tools and downloads game models on first run, which needs at least 15 gigabytes of free disk space and a modern NVIDIA GPU for the best speed, though weaker GPUs and CPU-only machines are supported with a smaller, slower model. Linux setup uses similar shell scripts on Debian, Fedora, or Arch-based systems. The project is explicit that it is a work in progress: some systems are incomplete and there is no built-in sign-in screen yet, so hosts are warned to keep the address private or put it behind a proxy before sharing it beyond a home network.

Yoink these prompts

Prompt 1
Walk me through setting up Grimoire on Windows using start.ps1 and connecting a friend over the same network.
Prompt 2
Explain how Grimoire's dice checks and 2014 SRD character creation work together during play.
Prompt 3
Help me troubleshoot Grimoire running slowly on a CPU-only machine with no dedicated GPU.
Prompt 4
Show me how to keep a Grimoire host running persistently for a multi-session campaign.

Frequently asked questions

wtf is grimoire?

A browser-based fantasy RPG where one host runs the game locally and an AI Dungeon Master narrates, voices, and illustrates the story as friends play together.

What language is grimoire written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, WebSocket.

How hard is grimoire to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is grimoire for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.