Files
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

3.3 KiB

Voice Agent Nodes

Text-to-speech through the voice agent: resolve voices (including the narrator's), unpack voice data and generate speech.

5 nodes.

Node Registry path
Generate TTS agents/tts/Generate
Get Narrator Voice agents/tts/GetNarratorVoice
Get Voice agents/tts/GetVoice
TTS Agent Settings agents/tts/Settings
Unpack Voice agents/tts/UnpackVoice

Generate TTS

agents/tts/Generate

Generates speech audio for the given text via the TTS agent and queues it for playback in the frontend. Either a voice or a character must be provided; when a character is given its assigned voice is used, while an explicit voice input overrides it. Does nothing when the TTS agent is disabled or not ready.

Inputs

Input Type Description
state any The graph state
text text (optional) The text to speak (required at runtime despite the optional socket)
voice tts/voice The voice to use (optional)
character character The character to speak as (optional)

Outputs

Output Type Description
state any The state input, passed through

Properties

Property Type Default Description
text text unset The text to generate

Get Narrator Voice

agents/tts/GetNarratorVoice

Gets the narrator voice from the TTS agent.

Outputs

Output Type Description
voice tts/voice

Get Voice

agents/tts/GetVoice

Looks up a voice in the TTS agent's voice library by voice ID.

Inputs

Input Type Description
voice_id str (optional) The ID of the voice to get (required at runtime despite the optional socket)

Outputs

Output Type Description
voice tts/voice The voice object (None if no voice with that ID exists)

Properties

Property Type Default Description
voice_id str unset The ID of the voice to get

TTS Agent Settings

agents/tts/Settings

Base node to render TTS agent settings.

Every setting of the tts agent is exposed as an output socket named after the setting - see the agent's documentation under Agents for what each setting does.

Unpack Voice

agents/tts/UnpackVoice

Unpacks a voice object into its individual fields.

Inputs

Input Type Description
voice tts/voice The voice to unpack

Outputs

Output Type Description
voice tts/voice The voice, passed through
label str The voice's display label
provider str The TTS provider (API) the voice belongs to
provider_id str The voice's ID at the provider
provider_model str The provider model the voice uses
tags list The voice's tags
parameters dict The voice's generation parameters
is_scene_asset bool Whether the voice is stored as a scene asset