Línea de comandos

python run.py [opciones]

Opción	Por defecto	Qué hace
--host	127.0.0.1	Dirección donde escucha el servidor (0.0.0.0 para todas, p. ej. en Docker)
--port	8765	Puerto HTTP y WebSocket
--model	según el perfil	Modelo de Whisper (por defecto, el del perfil de rendimiento)
--device	según el perfil	cuda (GPU NVIDIA) o cpu (por defecto, cuda si hay GPU)
--compute-type	según el perfil	Precisión de Whisper en CTranslate2: float16, int8_float16, int8…
--beam	según el perfil	Ancho de búsqueda de Whisper (5 segmenta mejor que 1)
--translator	según el perfil	none | opus-base | opus-big | nllb-1.3b | madlad-3b | repo de HF (Marian CT2) (por defecto, el del perfil)
--voice	según el perfil	none | omnivoice | chatterbox (por defecto, según el perfil)
--owner-password	vacío	Contraseña del dueño al arrancar (o TRANSLAY_OWNER_PASSWORD); hace falta cuando nadie entra desde 127.0.0.1, como en Docker
--allow-origin	vacío	Otro origen desde el que se puede usar la app (p. ej. https://translay.midominio.com detrás de un proxy que cambia el Host); se repite, o TRANSLAY_ORIGINS separados por comas
--no-browser	—	No abrir el navegador al arrancar
--data-dir	vacío	Carpeta de datos de la biblioteca Principal (o TRANSLAY_DATA; por defecto, data/ junto al código). La app de escritorio usa la que elegiste al instalar

python run.py --version muestra la versión instalada (Translay 1.4.0).

Variables de entorno

Variable	Para qué
TRANSLAY_OWNER_PASSWORD	Contraseña del dueño al arrancar; equivale a --owner-password. Ver Acceso.
TRANSLAY_ORIGINS	Otros orígenes permitidos, separados por comas; equivale a --allow-origin. Ver Otros sitios web.
HF_HOME	Dónde se guardan los modelos descargados de Hugging Face (en Docker, /models).
CT2_CUDA_CACHING_ALLOCATOR_CONFIG	Caché de memoria de CTranslate2; vt/gpu.py lo limita a 400 MB si no está definido.

Ejemplos

# sin GPU (lento, útil para probar la interfaz)
python run.py --device cpu --compute-type int8 --voice none

# otro traductor y otro puerto
python run.py --translator nllb-1.3b --port 9000

# escuchar en toda la red (además de «Acceso desde otros equipos» en Preferencias)
python run.py --host 0.0.0.0