---

name: server-and-cli description: "Operate Coqui TTS installed console commands and the safe local demo server." disable-model-invocation: true metadata: disco-role: operating license: MPL 2.0

Server And CLI

Use this sub-skill when the task is about the installed tts or tts-server console commands: checking availability, listing models, querying model metadata, building synthesis or voice-conversion commands, routing custom checkpoint paths, using pipe output, or safely starting the local demo server.

Do not use this sub-skill for Python API details, training commands, vocoder/audio preprocessing utilities, or production deployment design.

Fast route

1. For tts flag syntax and command templates, read references/cli-reference.md.
2. For tts-server help/list/run patterns and demo-server safety, read references/server-workflows.md.
3. For command failures and parser/runtime diagnoses, read references/troubleshooting.md. For install/import problems, also use the root troubleshooting reference at ../../references/troubleshooting.md.
4. Prefer bundled helpers before composing commands by hand:
   • scripts/check_tts_cli.py checks tts help/list/model-info paths without synthesis.
   • scripts/build_tts_command.py prints shell-quoted tts commands from validated inputs.
   • scripts/check_tts_server_cli.py checks tts-server help/list paths without binding a server.

Boundaries

• Model registry semantics, Python TTS.api.TTS, ModelManager, and Synthesizer usage belong in ../inference-and-model-zoo/SKILL.md.
• FreeVC source/target audio semantics and Python voice-conversion workflows belong in ../voice-conversion/SKILL.md. This sub-skill only covers the tts --source_wav --target_wav CLI surface.
• Training CLIs and dataset/config preparation belong in ../training-config-data/SKILL.md and vocoder/audio tools belong in ../vocoder-and-audio-tools/SKILL.md.
• Treat tts-server as a local demo interface. It can bind a port, run Flask debug mode, load large models, and download released checkpoints. Do not present it as a hardened persistent service.

Safe operating policy

• tts --help, tts --list_models, tts --model_info_by_name ..., tts --model_info_by_idx ..., tts-server --help, and tts-server --list_models are the preferred low-side-effect checks.
• Commands that load released models can create cache/network/disk side effects. Validate model names, output paths, device choice, and speaker/language requirements before running them.
• Commands that start tts-server must be opt-in. Choose a port deliberately, check whether it is free, avoid debug mode unless actively debugging, and remember that this version binds the Flask app to the unspecified host ::.