Files
talemate/docs/user-guide/templates/visual-finalizer.md
veguAI cc28def7c6 0.39.0 (#274)
- **Help Agent** — A new agent that answers questions about Talemate itself — settings, agents, clients, the world editor — grounded in the bundled documentation, and able to change agent and application settings on request.
- **Timeline Rollback** — Scrub a slider across a scene's automatic version history, preview the message history at any revision, then roll the scene back in place or fork the revision into a new save.
- **Pi Bridge Client** — A new client type that drives generations through the pi coding agent's headless RPC mode, making any model pi can reach usable in Talemate.
- **Application Settings** — Settings move out of their modal into an always-available Settings tab, with a single topic-grouped sidebar, a settings search, all API keys on one page, and unsaved-change tracking.
- **Scene Library** — The home screen is rebuilt as a full-page landing view with a file-tree scene library, cover thumbnails and per-save metadata, scene and save deletion, and a drag-and-drop import dropzone.
- **Fast Character Creation** — Generate a character in a single request instead of one prompt per aspect, with a Consolidate multi-select, a token budget, and a Fill in misses pass. Off by default.
- **Scene Backdrop** — Set any scene illustration as a backdrop filling the scene view behind the messages, saved with the scene, with configurable text legibility and an Immersive quick-toggle.
- **Scene Visual Manager** — World Editor → Scene gains a Visuals tab to browse, upload, generate and delete the scene's backgrounds and illustrations, and set the cover image and backdrop.
- **Visual Prompt Finalization** — Post-processing actions — match and replace, or a free-form AI instruction — rewrite image prompts right before they reach the image backend, with per-scene and per-character overrides and reusable template sets.

- fixes #271 
- fixes #275

Plus 25 improvements and 39 bug fixes — see [CHANGELOG.md](https://github.com/vegu-ai/talemate/blob/prep-0.39.0/CHANGELOG.md#0390) for the full list.
2026-08-29 13:21:22 +03:00

2.4 KiB

Visual Prompt Finalizer

Visual prompt finalizer templates define a reusable set of post-processing actions that rewrite image generation prompts right before they are sent to the image generation backend — exact, fuzzy or regex match and replace, or an AI instruction applied to the whole prompt.

They exist so you can maintain a set of actions once and insert it wherever it is needed, instead of recreating the same rows in the visualizer agent's Prompt Finalization settings for every configuration.

!!! info "Shipped preset: Ideogram JSON" Talemate ships an Ideogram JSON finalizer template that converts the positive prompt into an Ideogram 4.0 structured JSON prompt via an AI action. It appears in the preset picker out of the box.

Creating a visual prompt finalizer

--8<-- "docs/snippets/common.md:world-editor-create-group"

Next enter a template name and select Visual prompt finalizer as the template type.

Prompt finalizer name

The name / label of the template. This is the name displayed in the list of templates and in the preset picker.

Template description

A longer description of the template. What does this set of actions do, and when should it be used?

Favorite

Mark the template as a favorite to make it easier to find in the list of templates. Favorited templates are shown at the top of the list.

Actions

The table of post-processing actions, executed from top to bottom. The rows work exactly like the ones in the visualizer agent settings — see Post-processing Actions for a description of the available modes, flags, targets, and visual type restrictions.

Using a visual prompt finalizer

Open the visualizer agent settings and switch to the Prompt Finalization tab. The Preset picker below the actions table inserts the template's actions into the table as editable copies.

Because the rows are copied, you can reorder, edit, or remove them freely after inserting — and later changes to the template do not affect actions that were already inserted.

Editing and deleting

To edit an existing template, select it from the list of templates in the left sidebar and adjust the fields — updates are applied automatically.

To delete a template, select it and click the :material-close-box-outline: Remove Template button.