Home / Projects / NiPlex-Harness / Tools / Voice tools / set_voice

Pictures

set_voice

Picks a Piper voice and downloads it if needed.

Since 2 Sept 2026

Picks a Piper voice and downloads it if needed.

Tool name: set_voice
Group: Voice
Risk: low
Needs approval: never
Approval rule: No approval.
Allowed in scheduled jobs: No
Default: off

Parameters

Name	Type	Required	Default	Meaning	Limits
voice	string	Yes		Piper voice id, such as en_US-lessac-medium.

Returns

A confirmation.

Example (made up for this page)

Call

{
  "voice": "demo"
}

Result

Voice set.

Side effects

Downloads a model file and saves a setting.

How it can fail

When	What the agent sees
Bad voice name	Rejected
Download fails	Could not download voice

See also:Voice tools

Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.