Mythweaver Docs

Mythweaver documentation

How to use and run Mythweaver, a self-hosted app for AI role-play with one or many characters.

Mythweaver is a self-hosted app for AI role-play with one or many characters in a group chat. You bring the AI models (a hosted API or one you run yourself), write characters and lore, and play out scenes where the characters take turns replying.

You can use it by yourself, for your own RP, or with friends, in real-time group chats (Discord style). Users can be assigned characters, or it can be a big free-for-all.

Screenshots

Basic landing page Main chat
The command palette Pie menus
Analytics views Mobile UI

Where to start

  • New to Mythweaver? Follow Getting started: claim the install, connect a model and start your first chat.
  • Setting up a server? Read Installation and Environment variables.
  • Looking for something specific? Press / to search, or browse the sections below.

Sections

Section What it covers
Getting started The first run, connecting a model and your first chat.
Chats Messages, swipes, the composer, group chats and turn-taking, chat settings and sharing.
Characters The character editor, expressions and sprites.
AI connections and models Connections to AI providers, models and how a provider is picked for each call.
Prompts Prompts, blocks, outlets, the template language and variables.
Lore Lore books and entries, activation, timing, budgets, pools and vector lore.
Memory Memory Books: profiles, side prompts, consolidation, clips and character books.
Scripts Lua scripts that react to chat events, and the script API.
Images and attachments Attaching files, image descriptions and image settings.
Tools The assistant, the command palette, import and export, tags, jobs and MCP.
Account and settings Your account, settings, appearance and notifications.
Administration Installing and configuring the server, users and permissions, and moderation.