Search docs...

Start typing to search documentation

Chat Guide

Getting Started

Your first chat: loadouts, greetings, swipes, and branches.

Overview

The chat is a full roleplay engine in your browser. Characters, personas, lorebooks, presets, and every conversation live in a local database on your device; the server only relays model requests. You can use any catalog model or bring your own provider.

Open the chat from the top navigation. A new conversation starts on the chat home screen; everything you equip there can be changed later per conversation.

Loadout

The loadout is the sticky set of preset, persona, characters, and lorebooks that auto-equips on every new chat. Set it once on the chat home screen and each new conversation starts ready to go.

Per-conversation overrides live in the settings drawer inside the chat: swap the persona, add lorebooks, change sampling, or toggle features without touching your loadout.

Greetings

A character's first message opens the chat. If the card ships alternate greetings, a preview picker appears before your first send so you can choose the opening you like.

Greetings are macro-expanded once, so UnoRouter fills in names and random values at insertion time. Each greeting is a root branch: swiping on the first message switches between them.

Messages, swipes, and branches

Every reply can be regenerated. Regenerations become siblings of the original message, and you swipe between them; nothing is overwritten.

Conversations are trees, not lists. Editing or regenerating in the middle creates a new branch, and the previous line of the story stays intact and reachable.

A failed send stays in the timeline so you can retry manually; nothing is silently resent. Offline sends are marked as queued.

Auto-continue

With auto-continue enabled, a reply that stops mid-sentence automatically requests a continuation, up to three times. Toggle it per conversation in the settings drawer.

Where to go next

Import a character card, create a persona, and skim the Presets page to understand how the prompt is assembled. The Lorebooks and Macros pages unlock the deeper systems.

Ctrl K opens search across all docs pages.

Getting Started with UnoRouter Chat