git404hub

what is llm-dungeon fr?

tjurijs/llm-dungeon — explained in plain English

Analysis updated 2026-05-18

5TypeScriptAudience · generalComplexity · 2/5LicenseSetup · moderate

tl;dr

A local web app where an AI acts as a dungeon master for a text based role playing game, tracking your story and characters between sessions.

vibe map

mindmap
  root((llm-dungeon))
    What it does
      AI narrates the story
      Rolls dice for outcomes
      Saves campaign progress
    Tech stack
      Node.js
      TypeScript
      LLM APIs
    Use cases
      Solo tabletop style RPG
      Persistent story campaigns
      Multilingual role playing
    Audience
      Tabletop RPG fans
      Vibe coders
      Writers

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

what do people make with this?

VIBE 1

Play a solo text based role playing campaign with an AI dungeon master.

VIBE 2

Keep a persistent story with characters and locations that continue across sessions.

VIBE 3

Try out different AI models to see which tells the best story.

VIBE 4

Run a private, local role playing game without exposing it to the internet.

what's the stack?

Node.jsTypeScriptnpm

how it stacks up fr

tjurijs/llm-dungeoncprecioso/tubecasterfarique/cursor-chat-explorer
Stars555
LanguageTypeScriptTypeScriptTypeScript
Last pushed2025-03-29
MaintenanceStale
Setup difficultymoderatemoderateeasy
Complexity2/52/52/5
Audiencegeneralgeneraldeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Node.js 22 or newer and an API key from at least one supported LLM provider.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

llm-dungeon is a local web app that lets you play a text based role playing game with an AI acting as your dungeon master. You describe what your character does in plain language, and the AI narrates what happens next, rolling a visible hundred sided die whenever the outcome is uncertain, similar to how a tabletop game master might call for a dice roll. The app keeps track of your characters, locations, items, and story threads across sessions, so a campaign can be picked up again later exactly where you left off. You run it on your own computer with Node.js, and you connect it to an AI provider of your choice, such as Google Gemini, OpenAI, xAI, DeepSeek, or OpenRouter, using your own API key from that provider. Using these providers can cost money depending on your usage, and the app shows an estimated cost per campaign, though actual billing depends on the provider you pick. To start a campaign, you describe a premise and a character concept, optionally pick a specific AI model, and the app generates a preview you can accept, edit, or regenerate before playing. You can also ask the dungeon master a question without using up a turn, or appeal a result if something in the story seems inconsistent, such as an item disappearing from your inventory. The app supports both English and Russian for gameplay and its interface, and multiple separate campaigns can exist side by side. Campaigns can be archived to make them permanently read only, or deleted entirely, though deletion cannot be undone. Everything is saved locally in a data folder that can be backed up by copying it while the app is stopped. The project notes that the local server has no login protection or encryption and is meant to stay on your own computer rather than be exposed to the internet. It requires Node.js 22 or newer and is released under the Apache License 2.0, which allows free use including commercial use.

prompts (copy fr)

prompt 1
Walk me through installing llm-dungeon and connecting it to Google Gemini.
prompt 2
Explain how the d100 dice mechanic works when I take an uncertain action.
prompt 3
Show me how to create a new campaign with a custom premise and character.
prompt 4
Help me back up my campaign data folder before updating the app.

Frequently asked questions

what is llm-dungeon fr?

A local web app where an AI acts as a dungeon master for a text based role playing game, tracking your story and characters between sessions.

What language is llm-dungeon written in?

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

What license does llm-dungeon use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is llm-dungeon to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is llm-dungeon for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.