Available
The AI Assistant (Oracle)
Chat, analyse your scenes, extract characters and locations.
What it's for
The Oracle is the built-in AI assistant. It chats with an AI that knows your project (characters, locations, scenes) via a contextual database, the Lorebook.
It analyses your scenes to extract summaries, characters, locations, and timeline events, and offers a roleplay mode to "talk" with a character who responds faithfully to their card.
Step-by-step guide
Open the Oracle
1
AI tab (or Oracle): four tabs — Chat, Lorebook, Summaries, Character chat.
On first open, the Lorebook fills automatically from your existing cards (a few seconds).
Chat (Chat tab)
1
Create a conversation (left column) or select one.
2
Type your request then Enter. The AI takes the Lorebook into account if Use Lorebook is checked.
3
An empty conversation offers four clickable suggestions (style, summary, advice, inconsistencies).
Only the last 10 exchanges are sent to the AI. Conversations are saved.
Configure the persona
1
Persona button (bottom of the column): Author profile (genre, style, register, influences) and Assistant persona (name, personality, system instruction).
2
Generate prompt drafts the instruction from the fields (DeepSeek if configured, otherwise local fallback).
3
Save to library to reuse the persona on other projects.
Manage the Lorebook
1
Filter by type (character, location, scene, custom) and by search.
2
Eye icon: temporarily excludes an entry without deleting it. Add / pencil: create or edit (name and content required).
3
Check entries then Delete (N). Sync regenerates everything from your cards (local operation, no AI).
Analyse scenes (Summaries)
1
The tab lists scenes containing text. Generate / Regenerate produces a summary, keywords, characters/locations/relationships, timeline events, speech style, and arcana.
Scenes of more than 10,000 characters are analysed on their beginning only.
2
Generate all (scenes without a summary) / Regenerate all (all).
3
The new entities modal lets you create, merge (duplicate), or ignore detected characters/locations.
Talk to a character (Character chat)
1
Click a character: the AI embodies them via their card (traits, motivations, fears, biography, voice).
2
Automatic memory: older exchanges are summarised every 20 messages (badge + banner).
3
Header: History (clock), New conversation (+, keeps history), Clear (trash, confirmation).
Tips
◆
Uncheck Use Lorebook for a general question that does not concern your project.
◆
Raise the priority of important cards (protagonists, central locations): they come first in the context.
◆
Create several personas by genre (crime, fantasy…) and load one in one click.
◆
Run Generate all regularly: only new scenes are processed.
◆
The richer a character's card, the more faithful the Character chat.
◆
Without an active licence or if the AI is slow, configure your own key (OpenAI, Mistral, DeepSeek, Ollama…) in Settings.
Function reference
| Function | What it does |
|---|---|
| Create / Select / Delete | Manages Oracle conversations |
| Send a message | Sends with the Lorebook + persona context |
| Use Lorebook | Enables/disables Lorebook injection |
| Configure / Generate / Save persona | Author profile + assistant personality |
| Function | What it does |
|---|---|
| Filter | By type and text search |
| Enable/disable (eye) | Includes or excludes from context |
| Add / Edit / Delete | Manual entries (name, keywords, content, priority) |
| Sync | Regenerates from cards (local, no AI) |
| Function | What it does |
|---|---|
| Generate scene summary | Summary + entities + events + arcana + voice |
| Generate all / Regenerate all | Sequential scene analysis |
| New entities modal | Create / merge a duplicate / ignore |
| Character chat (roleplay) | AI embodies a character via their card |
| Memory compression | Summarises every 20 messages |