filliptm-ComfyUI_Fill-ChatterBox/README.md

ComfyUI_Fill-ChatterBox

A custom node extension for ComfyUI that adds text-to-speech (TTS) and voice conversion (VC) capabilities using the Chatterbox library. Supports a MAXIMUM of 40 seconds. Iv tried removing this limitarion but the model falls apart really bad with anything longer than that, so it remains.

Installation

1. Clone this repository into your ComfyUI custom_nodes directory:

   cd /path/to/ComfyUI/custom_nodes
   git clone https://github.com/filliptm/ComfyUI_Fill-ChatterBox.git
   

2. Install the base dependencies:

   pip install -r ComfyUI_Fill-ChatterBox/requirements.txt
   

Usage

Text-to-Speech Node (FL Chatterbox TTS)

• Add the "FL Chatterbox TTS" node to your workflow
• Configure text input and parameters (exaggeration, cfg_weight, temperature)
• Optionally provide an audio prompt for voice cloning

Voice Conversion Node (FL Chatterbox VC)

• Add the "FL Chatterbox VC" node to your workflow
• Connect input audio and target voice
• Both nodes support CPU fallback if CUDA errors occur

Change Log

5/31/2025

• Added Persistent model loading, and loading bar functionality
• Added Mac support (needs to be tested so HMU)
• removed the chatterbox-tts library and implemented native inference code.