mirror of
https://github.com/jamiepine/voicebox.git
synced 2026-09-15 21:00:42 -07:00
Jamie Pine
732d35ca89
- Revised README to include links for downloading the latest releases for macOS, Windows, and Linux. - Added detailed instructions for running Voicebox with Docker, including Docker Compose usage. - Updated installation documentation to reflect Linux availability and provide specific download options for AppImage and Deb packages. - Enhanced clarity in Docker documentation regarding accessing the web UI.
151 lines
3.8 KiB
Plaintext
151 lines
3.8 KiB
Plaintext
---
|
|
title: "Installation"
|
|
description: "Download and install Voicebox on macOS, Windows, or Linux"
|
|
---
|
|
|
|
## Download
|
|
|
|
Voicebox is available for macOS, Windows, and Linux.
|
|
|
|
<CardGroup cols={4}>
|
|
<Card title="macOS" icon="apple">
|
|
Download for Apple Silicon or Intel Macs
|
|
</Card>
|
|
<Card title="Windows" icon="windows">
|
|
Download MSI installer or Setup executable
|
|
</Card>
|
|
<Card title="Linux" icon="linux">
|
|
Download AppImage or Deb package
|
|
</Card>
|
|
<Card title="Docker" icon="docker" href="/overview/docker">
|
|
Run with web UI in a container
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
### macOS
|
|
|
|
<Tabs>
|
|
<Tab title="Apple Silicon">
|
|
Download: [voicebox_aarch64.app.tar.gz](https://github.com/jamiepine/voicebox/releases/latest/download/voicebox_aarch64.app.tar.gz)
|
|
|
|
```bash
|
|
# Extract the archive
|
|
tar -xzf voicebox_aarch64.app.tar.gz
|
|
|
|
# Move to Applications
|
|
mv Voicebox.app /Applications/
|
|
```
|
|
</Tab>
|
|
<Tab title="Intel">
|
|
Download: [voicebox_x64.app.tar.gz](https://github.com/jamiepine/voicebox/releases/latest/download/voicebox_x64.app.tar.gz)
|
|
|
|
```bash
|
|
# Extract the archive
|
|
tar -xzf voicebox_x64.app.tar.gz
|
|
|
|
# Move to Applications
|
|
mv Voicebox.app /Applications/
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
### Windows
|
|
|
|
<Tabs>
|
|
<Tab title="MSI Installer">
|
|
Download: [voicebox_x64_en-US.msi](https://github.com/jamiepine/voicebox/releases/latest/download/voicebox_x64_en-US.msi)
|
|
|
|
Double-click the MSI file and follow the installation wizard.
|
|
</Tab>
|
|
<Tab title="Setup Executable">
|
|
Download: [voicebox_x64-setup.exe](https://github.com/jamiepine/voicebox/releases/latest/download/voicebox_x64-setup.exe)
|
|
|
|
Run the executable and follow the installation wizard.
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
### Linux
|
|
|
|
<Tabs>
|
|
<Tab title="AppImage">
|
|
Download: [voicebox_x86_64.AppImage](https://github.com/jamiepine/voicebox/releases/latest)
|
|
|
|
```bash
|
|
# Make executable
|
|
chmod +x voicebox_x86_64.AppImage
|
|
|
|
# Run
|
|
./voicebox_x86_64.AppImage
|
|
```
|
|
</Tab>
|
|
<Tab title="Debian/Ubuntu">
|
|
Download: [voicebox_amd64.deb](https://github.com/jamiepine/voicebox/releases/latest)
|
|
|
|
```bash
|
|
# Install
|
|
sudo dpkg -i voicebox_amd64.deb
|
|
|
|
# Run
|
|
voicebox
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
<Note>
|
|
For headless server deployments, use [Docker](/overview/docker) instead of the desktop app.
|
|
</Note>
|
|
|
|
## First Launch
|
|
|
|
When you launch Voicebox for the first time:
|
|
|
|
1. **Model Download** — Qwen3-TTS model (~2-4GB) will download automatically on first use
|
|
2. **Data Directory** — Voice profiles and generated audio are stored in:
|
|
- macOS: `~/Library/Application Support/com.voicebox.app/`
|
|
- Windows: `%APPDATA%/com.voicebox.app/`
|
|
- Linux: `~/.config/com.voicebox.app/`
|
|
|
|
3. **Backend Server** — The bundled Python server starts automatically
|
|
|
|
<Tip>
|
|
First generation will be slower due to model downloads. Subsequent runs use cached models.
|
|
</Tip>
|
|
|
|
## System Requirements
|
|
|
|
### Minimum
|
|
|
|
- **OS:** macOS 11+, Windows 10+, or Linux
|
|
- **RAM:** 8GB
|
|
- **Storage:** 5GB free space (for models and data)
|
|
- **CPU:** Modern multi-core processor
|
|
|
|
### Recommended
|
|
|
|
- **RAM:** 16GB+
|
|
- **GPU:** CUDA-capable NVIDIA GPU (for faster generation)
|
|
- **Storage:** 10GB+ free space
|
|
|
|
<Note>
|
|
CPU inference is supported but significantly slower than GPU. A CUDA-capable GPU is highly recommended for real-time workflows.
|
|
</Note>
|
|
|
|
## Verification
|
|
|
|
After installation, verify everything works:
|
|
|
|
1. Launch Voicebox
|
|
2. Check the server status indicator in the bottom-left corner (should be green)
|
|
3. Navigate to **Profiles** and create a test profile
|
|
4. Generate a short audio clip to verify the TTS engine works
|
|
|
|
<Check>
|
|
If you see a green status indicator and can generate audio, you're all set!
|
|
</Check>
|
|
|
|
## Next Steps
|
|
|
|
<Card title="Quick Start Guide" icon="rocket" href="/overview/quick-start">
|
|
Create your first voice profile and generate speech
|
|
</Card>
|