Configurazione

Tutte le impostazioni sono variabili d’ambiente. Il minimo consigliato:

SECRET_KEY=<openssl rand -hex 32>   # required in production (sessions reset otherwise)
GOD_PASSWORD=<a strong password>
ANGEL_PASSWORD=<optional>
HUMAN_PASSWORD=<optional>

Se non viene impostata alcuna password, una GOD_PASSWORD casuale viene generata e stampata nei log del container all’avvio.

Tutte le variabili

Variabile	Predefinito	Descrizione
`SECRET_KEY`	(casuale)	Chiave di firma delle sessioni. Impostala in produzione.
`GOD_PASSWORD` / `ANGEL_PASSWORD` / `HUMAN_PASSWORD`	—	Password per ciascun livello di accesso.
`HUMAN_OPEN`	`false`	Consenti il livello HUMANO senza login (convertitore pubblico).
`WEB_CONCURRENCY`	`auto`	Worker paralleli. `auto` = numero di core della CPU.
`MAX_UPLOAD_MB`	`100`	Tetto assoluto alla dimensione dei caricamenti (eccetto DIOS).
`WHISPER_MODEL`	`base`	Modello di trascrizione: `tiny` · `base` · `small` · `medium` · `large-v3`.
`MAX_MEDIA_MINUTES`	`120`	Durata massima di audio/video da trascrivere (`0` = illimitata; DIOS non ha tetto).
`ENABLE_TTS`	`true`	Abilita la conversione testo→audio (narrazione e podcast).
`GOD_TTS_CHARS` / `ANGEL_TTS_CHARS` / `HUMAN_TTS_CHARS`	`0` / `100000` / `20000`	Tetto di caratteri per MP3 per ciascun ruolo (`0` = illimitato; DIOS illimitato per impostazione predefinita).
`HUMAN_TTS`	`false`	Consenti al livello HUMANO di generare audio.
`TTS_OPENAI_MODEL`	`tts-1`	Modello TTS cloud di OpenAI (`tts-1` o `tts-1-hd`); usa la chiave dell’utente.
`TTS_TIMEOUT`	`600`	Secondi massimi per sintesi audio.
`OPENAI_API_KEY` / `OPENROUTER_API_KEY` / `GOOGLE_API_KEY`	—	Chiavi IA lato server (fallback quando l’utente non ne fornisce). Usate solo da DIOS e ANGEL.
`API_TOKEN` / `API_TOKEN_ROLE`	— / `angel`	Token statico per l’automazione (n8n, script) e il ruolo a cui è associato.
`EMBEDDED_REDIS`	`true`	Redis integrato per il rate limiting condiviso. Imposta `false` + `REDIS_URL` per usarne uno esterno.
`YT_PROXY` / `YT_COOKIES`	—	Proxy / cookies.txt facoltativi per YouTube se le trascrizioni sono bloccate dall’IP del tuo server.
`ANONIMAL_URL`	—	Abilita l’anonimizzazione dei PII. Puntalo sul servizio interno Anonimal. Lascia vuoto per nascondere la funzione.
`ENABLE_DOCS`	`false`	Esponi Swagger su `/api/docs`.
`PORT`	`8000`	Porta del container.

I limiti per livello (*_MAX_MB, *_MAX_BATCH, *_RATE) e i preset sono documentati in .env.example nel repository.