README.docker.md

metadata

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.