# EchoLocal Clone a voice from a short recording and make it speak in 23 languages, translate the text on the fly, and turn speech back into text. Everything runs on your computer: no cloud service, no account, no upload. The voices never leave the machine. Built on [Chatterbox Multilingual](https://github.com/resemble-ai/chatterbox) (voice cloning), [NLLB-200](https://huggingface.co/facebook/nllb-200-distilled-600M) (translation) and [faster-whisper](https://github.com/SYSTRAN/faster-whisper) (speech to text and a check of every generated clip). ## Features - **Web interface** on `http://127.0.0.1:7860`, reachable from this computer only. It follows the browser's language (English and Italian for now). - *Text to speech*: pick a voice, write the text once, tick the output languages. "Translate" fills an editable box per language; a box left empty is translated when you press "Generate". Output is one file per language (lines joined with a pause) or one clip per line, each with a player, a download link and the Whisper check. - *Speech to text*: upload a file or record from the microphone, get the transcript plus `.txt` and `.srt` (subtitles with timing). "Use as text to speak" sends it to the other tab. - **Command line** for batches: one clip per line or one file per language, from text files already written in each language or translated on the fly from one of them. - **Whisper check**: every generated clip is transcribed back and compared with its text, so the words to listen to again are listed for you. ## Requirements | System | Notes | |---|---| | Windows 10/11 with an NVIDIA GPU | Recommended. Driver 550 or newer (CUDA 12.4). About 4 GB of VRAM for Chatterbox plus 2 GB for Whisper: 8 GB is enough. | | Windows without an NVIDIA GPU | Works on the CPU, but slowly (about a minute per sentence). | | Mac with Apple Silicon (M1 or later), macOS 14+ | Chatterbox on the Apple GPU (`mps`), Whisper on the CPU. | | Intel Mac, macOS 12+ | CPU only, older pinned versions (torch 2.2.2), about 1-2 minutes per sentence. The web interface is untested there. | Disk: about 8 GB for the models plus 3 GB for the Python packages. Internet is needed only during setup. [uv](https://docs.astral.sh/uv/) is installed automatically if missing. ## Install Windows, from PowerShell in this folder: ```powershell powershell -ExecutionPolicy Bypass -File .\setup.ps1 ``` Mac: ```bash bash setup.sh ``` Setup creates two virtual environments (`Chatterbox/venv`, `Whisper/venv`), installs the exact tested versions, then downloads the models from Hugging Face: Chatterbox (4 GB) into `Chatterbox/models`, NLLB-200 (2.4 GB) into `WebUI/models`, Whisper large-v3-turbo (1.6 GB) into `Whisper/models`. After that every script runs offline. | Windows | Mac | Effect | |---|---|---| | `-Cpu` | | CPU build even if an NVIDIA GPU is present | | `-SkipWhisper` | `--skip-whisper` | No speech to text and no check | | `-SkipTranslation` | `--skip-translation` | No translation model: write each language yourself | | `-SkipModels` | `--skip-models` | Packages only, no model download | Setup can be run again at any time: it rebuilds the environments and keeps the models already downloaded. If a download is interrupted, run it again to resume. ## Add a voice Put an audio file (wav, m4a, mp3, flac, ogg) in `voices/`, or record one in the web interface (*Record a new voice*: it is saved in `voices/` under the name you give it). The file name is the voice name. A good sample is 5-15 s of one person speaking naturally, without music or other voices. Only the first 10 s are used, and silence at both ends is trimmed automatically. Microphone and room end up in the cloned voice, so they matter as much as the speaker. ## Web interface ``` webui.bat (Windows) ./webui.sh (Mac) ``` The first start loads Chatterbox (about 30 s); then it stays in memory. Options: `--port 7861` for another port, `--no-browser` to not open the browser. The *Title* names the job: results go to `outputs/