explaingit

emotion-machine-org/personaplex-finetune

Analysis updated 2026-05-18

4PythonAudience · researcherComplexity · 5/5Setup · hard

TLDR

An experimental pipeline that fine-tunes a voice AI model to handle specific professional call types like insurance or pharmacy support.

Mindmap

mindmap
  root((repo))
    What it does
      Synthetic dialogue generation
      Voice model finetuning
      Live context injection
    Tech stack
      Python
      LoRA FSDP
      VibeVoice TTS
      WhisperX
    Use cases
      Train domain specific voice agents
      Study LoRA finetuning fixes
      Generate synthetic call datasets
    Audience
      Researchers
      ML engineers
    Setup
      Two Python venvs
      Multi GPU required
      Anthropic API key
    Limits
      Work in progress
      Not widely tested

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

What do people build with it?

USE CASE 1

Fine-tune PersonaPlex on a specific domain like pharmacy or insurance calls.

USE CASE 2

Generate synthetic voice training data using Claude and VibeVoice.

USE CASE 3

Study documented LoRA finetuning failure modes and their fixes.

USE CASE 4

Use the puppeteer LLM pattern to inject live context into a voice model.

What is it built with?

PythonPyTorchLoRAFSDPWhisperX

How does it compare?

emotion-machine-org/personaplex-finetuneadeliox/klein-head-swapats4321/ragit
Stars444
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity5/53/52/5
Audienceresearcherdesignerdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1day+

Needs 3 to 5 GPUs with 24GB VRAM (or one H100) plus an Anthropic API key.

No license was found in the README, so it is unclear what uses are permitted.

In plain English

This is an unofficial pipeline for fine tuning PersonaPlex, a variant of the Moshi 7B voice model with voice and role conditioning, on specific professional domains such as pharmaceutical patient support or insurance brokerage calls. The pipeline works in several stages. First, it uses Claude to generate synthetic dialogue scripts between an agent and a client, including structured context injection markers. These scripts are converted to audio using VibeVoice, a text to speech system, producing stereo recordings with the agent and client on separate audio channels. The audio is aligned using WhisperX, a speech recognition and alignment tool, and the dataset is then used to fine tune PersonaPlex using LoRA, a technique that trains a small set of additional weights rather than retraining the full model, with FSDP across multiple GPUs. At inference time, an external puppeteer language model injects context tokens into the model's text stream through a hidden channel, allowing the model to receive live grounding information mid conversation without that context appearing in the output. The authors ran 84 training runs on insurance and pharmaceutical datasets totaling roughly 3,800 and 2,000 synthetic dialogues respectively. They document five recurring failure modes and the two fixes that mattered most: setting text_padding_weight to 0.0 to eliminate a PAD token collapse failure, and applying L2 regularization on LoRA B weights to prevent catastrophic forgetting. Requirements include Python 3.10 or newer, 3 to 5 GPUs with 24 GB VRAM each, RTX 4090 tested, or a single H100, plus an Anthropic API key for dialogue generation. The project is described by its authors as a work in progress, not yet tested on a wide range of setups. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Walk me through the full pipeline from dialogue generation to trained checkpoint.
Prompt 2
Explain what text_padding_weight=0.0 fixes in this PersonaPlex finetuning setup.
Prompt 3
Help me set up the two Python virtual environments this project needs.
Prompt 4
Summarize the five recurring training failure modes described in this repo.

Frequently asked questions

What is personaplex-finetune?

An experimental pipeline that fine-tunes a voice AI model to handle specific professional call types like insurance or pharmacy support.

What language is personaplex-finetune written in?

Mainly Python. The stack also includes Python, PyTorch, LoRA.

What license does personaplex-finetune use?

No license was found in the README, so it is unclear what uses are permitted.

How hard is personaplex-finetune to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is personaplex-finetune for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.