Roles & access levels
Login is required. Each level has its own password and limits, all configurable via environment variables.
| Capability | 👤 HUMANO | 😇 ANGEL | 👑 DIOS |
|---|---|---|---|
| Upload & convert files | ✓ | ✓ | ✓ |
| Convert from a public URL | — | ✓ (anti-SSRF) | ✓ |
Internal URL / file:// / local path | — | — | ✓ |
| Audio / video / ZIP | — | ✓ | ✓ |
| YouTube transcripts | ✓ | ✓ | ✓ |
| OCR (forced / automatic) | — | ✓ | ✓ |
| Use server-side AI keys | — | ✓ | ✓ |
| Max file size | 25 MB | 100 MB | unlimited |
| Files per batch | 3 | 10 | unlimited |
| Server stats (CPU/RAM) | — | partial | full |
| Rate limit (req/min) | 15 | 60 | unlimited |
All limits are configurable via environment variables (see Configuration).
Public mode
Section titled “Public mode”Set HUMAN_OPEN=true to let anyone use the HUMANO level without logging in — a
public converter with the HUMANO limits. The ANGEL and DIOS levels always require
their password.
Picking a level for automation
Section titled “Picking a level for automation”For scripts and integrations (n8n, cron jobs), define an API_TOKEN and map it to a
role with API_TOKEN_ROLE (defaults to angel). See the API page.