Lleve Escriba a casa

Escriba se distribuye como una única imagen de Docker prediseñada que ya incluye todo lo que necesita — ffmpeg, Tesseract OCR, Whisper y un Redis integrado. No hay servicios extra que conectar. Descárguela, defina una contraseña y tendrá un motor privado de documento-a-Markdown corriendo sobre su propia infraestructura.

¿Por qué autoalojar?

Sus documentos se convierten en su máquina y se eliminan justo después. No se almacena nada, no se envía nada a una nube de terceros. El control se queda en la capa humana — usted decide qué llega alguna vez a un LLM.

Inicio rápido

Descargue la imagen y ejecútela con un solo comando:

Ejecutar Escriba

docker run -d --name escriba --restart unless-stopped -p 8000:8000 \
-e SECRET_KEY="$(openssl rand -hex 32)" \
-e GOD_PASSWORD="change-me" \
ghcr.io/diegoparras/escriba:latest

Luego abra http://localhost:8000 e inicie sesión con la GOD_PASSWORD que definió.

Nota

La imagen incluye ffmpeg, Tesseract OCR, Whisper y Redis integrado. No se requieren servicios adicionales. Genere claves con openssl rand -hex 32.

Despliegue en su plataforma

Todo corre desde la única imagen de arriba. Elija la plataforma que usa.

EasyPanel

1. Project → + Service → App, luego configure Source → Docker Image con ghcr.io/diegoparras/escriba:latest.
2. Agregue sus variables de entorno (vea Configuración).
3. En Domains, establezca Container Port 8000, agregue su dominio y habilite HTTPS.
4. Deploy.

Docker Compose

git clone https://github.com/diegoparras/escriba.git
cd escriba
cp .env.example .env          # set your secrets
docker compose up -d --build

Portainer

Stacks → Add stack → Repository usando https://github.com/diegoparras/escriba y la ruta de compose docker-compose.yml (o pegue el archivo compose en el editor web). Defina las variables de entorno y despliegue; la app escucha en el puerto 8000.

Dokploy

Create Application → GitHub (repo diegoparras/escriba) con Build Type: Dockerfile, agregue sus variables de entorno, apunte el dominio al Container Port 8000 con HTTPS y despliegue.

Docker simple

docker build -t escriba .
docker run -d --name escriba --restart unless-stopped -p 8000:8000 \
-e SECRET_KEY="$(openssl rand -hex 32)" -e GOD_PASSWORD="change-me" escriba

Para TLS, coloque un proxy inverso delante. Con Caddy, un Caddyfile de dos líneas le da HTTPS automático:

Caddyfile

example.com {
    reverse_proxy localhost:8000
}

Configuración mínima

Todos los ajustes son variables de entorno. El mínimo recomendado:

.env

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

Si no se define ninguna contraseña, se genera una GOD_PASSWORD aleatoria y se imprime en los logs del contenedor al arrancar. Vea la lista completa en Configuración.

Requisitos

La app base es liviana: un VPS de 1 núcleo / 2 GB con ~5 GB de disco alcanza de verdad para empezar, y Escriba escala los workers según su CPU. El módulo opcional de anonimización de PII empresarial (Anonimal) es más pesado — móntelo solo cuando lo necesite.

Asegúrese antes de desplegar

Listamos especificaciones mínimas y recomendadas honestas para cada configuración — app base, anonimización empresarial y transcripción pesada — para que nunca sienta que “no funciona” por culpa de su máquina. Vea los requisitos de sistema completos →

Guía completa de despliegue Todas las opciones de configuración