gitwtfhub

wtf is voxweaver-studio?

nicekate/voxweaver-studio — explained in plain English

Analysis updated 2026-05-18

14TypeScriptAudience · writerComplexity · 3/5Setup · moderate

TL;DR

A self hosted web app that combines Fish Audio text to speech with DeepSeek AI to produce single, batch, and multi role voice audio.

Mindmap

mindmap
  root((repo))
    What it does
      Text to speech
      AI text optimization
      Multi role scripting
    Tech stack
      TypeScript
      Fish Audio
      DeepSeek
      ffmpeg
    Use cases
      Voice overs
      Audio drama
      Batch narration
    Audience
      Content creators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Turn a script into narrated audio using Fish Audio text to speech with DeepSeek text cleanup.

REASON 2

Batch convert a folder of text files into individual voice-over audio clips and export them as a zip.

REASON 3

Produce a multi character audio drama by splitting a script into roles and assigning a distinct cloned voice to each.

REASON 4

Create and reuse a persistent voice clone for a recurring character across multiple projects.

What's in the stack?

TypeScriptReactViteExpressffmpegFish AudioDeepSeek

How it stacks up

nicekate/voxweaver-studio0xbebis/hyperpayalfredxw/nova
Stars141414
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardmoderate
Complexity3/55/53/5
Audiencewriterdeveloperwriter

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Fish Audio and DeepSeek API keys plus ffmpeg installed and on your system PATH.

Wtf does this do

VoxWeaver Studio is a web application you run on your own computer for producing AI generated voice audio. It combines a text to speech service called Fish Audio with a language model called DeepSeek to optimize written text before turning it into speech, and it can handle everything from a single piece of text to large multi role scripts. For a single script, you can type or upload a text file, optionally let DeepSeek clean up or improve the wording, add emotion and style cues, choose a voice, and generate a preview before downloading the final audio file with a timestamped name. For larger jobs, a batch mode accepts multiple text files at once, applies AI optimization to each one individually, and exports all the finished audio as a single zip file. The Studio section is built for scripts with several characters. You paste in a long piece of text, ask the AI to split it into roles, review or manually fix any parts it could not confidently assign, and then have each role audition different voices, generate a full preview, and lock in a voice that gets saved as a reusable clone for that character. Finished lines then queue up and get merged into one combined output file. Voices can come from a default library, an existing Fish Audio voice referenced by its ID, an instant clone created from short reference audio, or a persistent clone that Fish Audio trains and stores under your account. Running it locally requires Node.js 18 or newer, the pnpm package manager, and ffmpeg installed and available on your system path, along with API keys for Fish Audio and DeepSeek stored in a local .env file. The interface can be switched between Chinese and English from the main screen. The README stresses that API keys are read only on the backend server and should never be placed in frontend code or committed to version control, and it includes a troubleshooting table for common setup errors.

Yoink these prompts

Prompt 1
Show me how to set up my .env file with FISH_API_KEY and DEEPSEEK_API_KEY to run VoxWeaver Studio locally.
Prompt 2
Walk me through using the Studio mode to split a script into roles and lock a voice for each character.
Prompt 3
Explain the difference between reference_id, instant clone, and persistent clone voice binding in this app.
Prompt 4
Help me troubleshoot a ffmpeg is not installed error while running VoxWeaver Studio.

Frequently asked questions

wtf is voxweaver-studio?

A self hosted web app that combines Fish Audio text to speech with DeepSeek AI to produce single, batch, and multi role voice audio.

What language is voxweaver-studio written in?

Mainly TypeScript. The stack also includes TypeScript, React, Vite.

How hard is voxweaver-studio to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is voxweaver-studio for?

Mainly writer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.