Configuration
All settings are environment variables. The recommended minimum:
SECRET_KEY=<openssl rand -hex 32> # required in production (sessions reset otherwise)GOD_PASSWORD=<a strong password>ANGEL_PASSWORD=<optional>HUMAN_PASSWORD=<optional>If no password is set, a random GOD_PASSWORD is generated and printed to the
container logs on startup.
All variables
Section titled “All variables”| Variable | Default | Description |
|---|---|---|
SECRET_KEY | (random) | Session signing key. Set it in production. |
GOD_PASSWORD / ANGEL_PASSWORD / HUMAN_PASSWORD | — | Password for each access level. |
HUMAN_OPEN | false | Allow the HUMANO level without login (public converter). |
WEB_CONCURRENCY | auto | Parallel workers. auto = number of CPU cores. |
MAX_UPLOAD_MB | 100 | Absolute upload size cap (except DIOS). |
WHISPER_MODEL | base | Transcription model: tiny · base · small · medium · large-v3. |
MAX_MEDIA_MINUTES | 120 | Max audio/video duration to transcribe (0 = unlimited; DIOS has no cap). |
ENABLE_TTS | true | Enable text→audio (narration & podcast). |
GOD_TTS_CHARS / ANGEL_TTS_CHARS / HUMAN_TTS_CHARS | 0 / 100000 / 20000 | Per-role character cap per MP3 (0 = unlimited; DIOS unlimited by default). |
HUMAN_TTS | false | Allow the HUMANO level to generate audio. |
TTS_OPENAI_MODEL | tts-1 | OpenAI cloud TTS model (tts-1 or tts-1-hd); uses the user’s key. |
TTS_TIMEOUT | 600 | Max seconds per audio synthesis. |
OPENAI_API_KEY / OPENROUTER_API_KEY / GOOGLE_API_KEY | — | Server-side AI keys (fallback when the user provides none). Used by DIOS and ANGEL only. |
API_TOKEN / API_TOKEN_ROLE | — / angel | Static token for automation (n8n, scripts) and the role it maps to. |
EMBEDDED_REDIS | true | Built-in Redis for shared rate limiting. Set false + REDIS_URL for an external one. |
YT_PROXY / YT_COOKIES | — | Optional proxy / cookies.txt for YouTube if transcripts are blocked from your server IP. |
ANONIMAL_URL | — | Enables PII anonymization. Point it at the internal Anonimal service. Leave empty to hide the feature. |
ENABLE_DOCS | false | Expose Swagger at /api/docs. |
PORT | 8000 | Container port. |
Per-level limits (*_MAX_MB, *_MAX_BATCH, *_RATE) and presets are documented in
.env.example in the repository.