Files
talemate/docs/user-guide/node-editor/reference/nodes/agents-visual-modules.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

8.2 KiB

Visualizer Agent Modules

Ready-made visual generation flows built on the visualizer prompt and generation nodes: generate visual assets, avatars, portraits, image edits and regenerations, plus the visualizer's websocket handlers.

10 nodes.

Node Registry path
Determine Visual References agents/visual/determineVisualReferences
Generate Avatar agents/visual/generateAvatar
Generate Character Portrait Legacy agents/visual/GenerateCharacterPortrait
Generate Image Edit agents/visual/generateImageEdit
Generate Visual Asset agents/visual/generateVisualAsset
Regenerate Visual Asset agents/visual/regenerateVisualAsset
Set Cover Image From Generation agents/visual/setCoverImageFromGeneration
Wsh Generate Visual Asset Tags agents/visual/wshGenerateVisualAssetTags
Wsh Regenerate Visual Asset agents/visual/wshRegenerateVisualAsset
Wsh Visualize agents/visual/wshVisualize

Determine Visual References

agents/visual/determineVisualReferences

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/determine-visual-references.json.

Inputs

Input Type Description
state any
prompt str
vis_type str

Outputs

Output Type Description
state any
prompt str
references list
vis_type str
asset_ids list

Generate Avatar

agents/visual/generateAvatar

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-avatar.json.

Inputs

Input Type Description
state any
character character
instructions str
set_current_avatar bool
set_default_avatar bool
tags list (optional)
asset_name str (optional)
asset_ctx asset_attachment_context (optional)

Outputs

Output Type Description
state any
character character
instructions str
set_current_avatar bool
set_default_avatar bool
tags list
asset_name str
asset_ctx asset_attachment_context
generation_request visual/generation_request

Generate Character Portrait Legacy

agents/visual/GenerateCharacterPortrait

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-character-portrait-legacy.json.

Inputs

Input Type Description
state any
character any
instructions str (optional)

Outputs

Output Type Description
state any
character any
instructions str

Generate Image Edit

agents/visual/generateImageEdit

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-image-edit.json.

Inputs

Input Type Description
state any
instructions str
asset_id str
callback function (optional)
asset_ctx asset_attachment_context (optional)
vis_type str (optional)
format str (optional)

Outputs

Output Type Description
state any
instructions str
asset_id str
asset_ctx asset_attachment_context
vis_type str
format str
generation_request visual/generation_request
generation_response visual/generation_response

Generate Visual Asset

agents/visual/generateVisualAsset

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-visual-asset.json.

Inputs

Input Type Description
state any
character character (optional)
vis_type str
instructions str (optional)
prompt_only bool (optional)
callback function (optional)
asset_ctx asset_attachment_context (optional)

Outputs

Output Type Description
state any
character character
vis_type str
instructions str
prompt_only bool
callback function
asset_ctx asset_attachment_context
prompt str
visual_prompt visual/prompt
generation_request visual/generation_request

Regenerate Visual Asset

agents/visual/regenerateVisualAsset

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/regenerate-visual-asset.json.

Inputs

Input Type Description
state any
asset_id str
asset_ctx asset_attachment_context (optional)
instructions str (optional)
callback function (optional)

Outputs

Output Type Description
state any
asset_id str
asset_ctx asset_attachment_context
instructions str
callback function

Set Cover Image From Generation

agents/visual/setCoverImageFromGeneration

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/set-cover-image-from-generation.json.

Inputs

Input Type Description
state any
generation_response visual/generation_response
reference_for list (optional)

Outputs

Output Type Description
state any
generation_response visual/generation_response
asset_id str
reference_for list

Wsh Generate Visual Asset Tags

agents/visual/wshGenerateVisualAssetTags

Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/visual/modules/wsh-generate-visual-asset-tags.json.

Outputs

Output Type Description
fn function
name str
allow_multiple_calls bool
ai_callback focal/callback

Properties

Property Type Default Description
agent str "visual" The agent to register the handler on. Choices are generated at runtime.
name str "generate_tags" The name of the handler

Wsh Regenerate Visual Asset

agents/visual/wshRegenerateVisualAsset

Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/visual/modules/wsh-regenerate-visual-asset.json.

Outputs

Output Type Description
fn function
name str
allow_multiple_calls bool
ai_callback focal/callback

Properties

Property Type Default Description
name str "revisualize" The name of the handler
agent str "visual" The agent to register the handler on. Choices are generated at runtime.

Wsh Visualize

agents/visual/wshVisualize

Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/visual/modules/wsh-visualize.json.

Outputs

Output Type Description
fn function
name str
allow_multiple_calls bool
ai_callback focal/callback

Properties

Property Type Default Description
agent str "visual" The agent to register the handler on. Choices are generated at runtime.
name str "visualize" The name of the handler