# VoiceStudio Speech Generation

Generates local speech, transcribes audio and runs dubbing through VoiceStudio's API.

- Repository: https://github.com/debpalash/VoiceStudio (97804 stars)
- Category: Media
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add debpalash/VoiceStudio --skill voicestudio -g -a claude-code -y`
Codex: `npx skills add debpalash/VoiceStudio --skill voicestudio -g -a codex -y`
Cursor: `npx skills add debpalash/VoiceStudio --skill voicestudio -g -a cursor -y`
Gemini CLI: `npx skills add debpalash/VoiceStudio --skill voicestudio -g -a gemini-cli -y`

## Description

Generate local speech with saved or designed voices, transcribe audio, and automate dubbing or narration workflows through VoiceStudio's REST API or MCP server. Use when the user wants to work with VoiceStudio audio or connect it to an agent or automation.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# VoiceStudio

Use the user's running [VoiceStudio](https://github.com/debpalash/VoiceStudio) backend. Prefer local processing; cloud translation, model downloads, remote-backend connections, and external integrations require the user's choice. Installed models can run offline; do not promise that every configured workflow is offline.

## Connect and discover

The default backend is `http://localhost:3900`; honor the user's configured address. Electron's renderer and development proxy are separate services, not the public backend API.

1. Check `GET /health`.
2. Discover the running version's contracts with `GET /openapi.json`, and voices/engines with `GET /v1/audio/voices`. Do not invent profile IDs or infer installed models from a catalog listing.
3. If unavailable, launch the installed app. For an existing source checkout, follow its Electron README (`bun install`, `bun run setup:api`, then `bun run dev` from the repository root). Do not install a second backend or overwrite an existing checkout.
4. Local configurations may permit unauthenticated calls; protected deployments require the configured credentials. Treat 401/403 as authentication failures, not permission to disable auth. Never print tokens or use a placeholder key as if it were a real credential.

## Generate speech

Save this JSON to `speech-request.json`, replacing `voice` with a discovered profile ID when the user selected a voice:

```json
{"model":"tts-1","voice":"alloy","input":"Every voice has a story. Let's tell yours.","response_format":"wav"}
```

```sh
curl --fail-with-body --show-error http://localhost:3900/v1/audio/speech \
  -H 'Content-Type: application/json' --data-binary @speech-request.json \
  --output speech.wav
```

The rest: https://github.com/debpalash/VoiceStudio/blob/HEAD/skills/voicestudio/SKILL.md