---
title: VoiceCraft CPU Clone Server
emoji: 🎙️
colorFrom: gray
colorTo: blue
sdk: docker
app_port: 7860
---

# VoiceCraft Docker Worker 3.1.2

This worker serves FastAPI endpoints for TTS, optional Pocket TTS CPU voice cloning, health checks, Firebase license validation, device limits, monthly credits, and per-user worker assignments.

## Protected Space settings

Required:

- `VOICECRAFT_AUTH_MODE=license`
- `FIREBASE_SERVICE_ACCOUNT_JSON=<complete Firebase service-account JSON>`
- `VOICECRAFT_SPACE_ID=auto`

For TTS only:

- `ENABLE_CLONE_ENGINES=0`

For voice cloning:

- `ENABLE_CLONE_ENGINES=1`
- `HF_TOKEN=<Hugging Face read token after accepting Pocket TTS terms>`

Optional:

- `VOICECRAFT_MAX_CONCURRENT_JOBS=1`
- `MIN_CLIENT_VERSION=3.0.0`
- `TTS_REQUESTS_PER_MINUTE=60`
- `CLONE_REQUESTS_PER_MINUTE=8`

Configure the matching Space document in the private VoiceCraft admin dashboard. Set its URL, enabled state, public/private visibility, clone capability, priority, and capacity. Private worker access is enforced again by the worker, so knowing its URL is not sufficient.

The worker exposes `/health`, `/status`, `/all_voices`, `/register_user`, `/activate_license`, `/license_status`, and `/tts`.

Do not add service-account JSON, HF tokens, or API secrets to repository files or public Space variables. Use protected Space secrets only.