whatisgithub

What is rpgraph?

unrefined803/rpgraph — explained in plain English

Analysis updated 2026-05-18

38TypeScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

In one sentence

A desktop app for offline AI roleplay with a visual workflow builder, story chat, and an in-world phone where characters can text, post, and use apps. Connects to local or cloud AI models.

Mindmap

mindmap
  root((repo))
    What it does
      Visual story builder
      Roleplay chat window
      Character phone
    Tech stack
      TypeScript
      Desktop app
      Local AI connectors
    Use cases
      Offline AI roleplay
      Character storytelling
      Social media simulation
    Features
      Per-character voice colors
      In-world time tracking
      Voice narration
      Encrypted save files
    Audience
      Roleplay enthusiasts
      Creative writers
      Vibe coders

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 build with it?

USE CASE 1

Build interactive AI roleplay stories with branching workflows on your own computer.

USE CASE 2

Simulate characters texting and posting on social media through the in-world phone.

USE CASE 3

Mix and match local and cloud AI models for different story tasks like narration or phone texts.

USE CASE 4

Import existing characters and world context from SillyTavern to continue stories.

What is it built with?

TypeScriptElectronLM StudioOllamallama.cppOpenRouterComfyUI

How does it compare?

unrefined803/rpgraphcaglaryalcin/lockstepdiegosouzapw/omniglyph
Stars383838
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyeasy
Complexity3/52/53/5
Audiencevibe codergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a local AI backend like Ollama or LM Studio running separately, or a cloud API key for OpenRouter or Google Gemini.

Free to use and modify, but any distributed versions must also be open source under the same license and include source code.

So what is it?

RPGraph Studio is a desktop application for interactive AI roleplay that runs entirely on your own computer. Instead of a simple chat window, it gives you a full creative studio with three main parts: a visual workflow where you design how the story is built, a roleplay chat where the results appear, and an in-world phone that characters use to text, post, and interact with apps. Nothing is sent to the cloud and no subscription is required. The app splits each story turn into several focused AI calls rather than sending one large request. Different situations, like normal replies, phone texts, narrator turns, or social posts, each get their own prompt automatically. You can also assign different AI models to different tasks, so a small local model can handle simple jobs while a larger model handles the actual roleplay. It connects to several local AI tools, including LM Studio, Ollama, and llama.cpp, as well as cloud services like OpenRouter and Google Gemini. The character phone is a standout feature. It is a phone-style interface with its own apps: a messenger called WhatsUp, social media platforms called Fotogram and OnlyFriends, a camera and gallery, a banking app with accounts and transfers, and a notes app. Messages from these apps appear inline within the story, so characters can text each other or post on social media and it all becomes part of the narrative. The app also tracks in-world time, highlights spoken dialogue with per-character colors, and can optionally generate voice narration. RPGraph supports storybooks that hold characters, world context, and images, including imports from SillyTavern. An optional ComfyUI connection adds image and voice generation. Everything saves as files on your disk, either as plain JSON or as password-encrypted files. The project is in beta, licensed under AGPL v3.0, and the developer notes that bugs are expected since it is a hobby project built with AI assistance.

Copy-paste prompts

Prompt 1
Help me install and set up RPGraph Studio so it connects to Ollama running locally on my machine.
Prompt 2
Walk me through creating a visual workflow in RPGraph that splits a story turn into separate AI calls for phone texts, narration, and replies.
Prompt 3
I have a SillyTavern character card JSON. Help me import it into RPGraph Studio and set up the character with the in-world phone apps.
Prompt 4
Show me how to configure RPGraph to use a small local model for phone messages and a larger cloud model via OpenRouter for main roleplay replies.
Prompt 5
Help me set up the ComfyUI connection in RPGraph so characters can generate images and voice narration during the story.

Frequently asked questions

What is rpgraph?

A desktop app for offline AI roleplay with a visual workflow builder, story chat, and an in-world phone where characters can text, post, and use apps. Connects to local or cloud AI models.

What language is rpgraph written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, LM Studio.

What license does rpgraph use?

Free to use and modify, but any distributed versions must also be open source under the same license and include source code.

How hard is rpgraph to set up?

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

Who is rpgraph for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.