Traga o Escriba para casa

O Escriba é distribuído como uma única imagem Docker pré-construída que já inclui tudo o que precisa — ffmpeg, Tesseract OCR, Whisper e um Redis embutido. Não há serviços extras para configurar. Baixe-a, defina uma senha, e você terá um motor privado de documento-para-Markdown rodando na sua própria infraestrutura.

Por que auto-hospedar?

Seus documentos são convertidos na sua máquina e apagados logo em seguida. Nada é armazenado, nada é enviado a uma nuvem de terceiros. O controle permanece na camada humana — você decide o que chega a uma LLM.

Início rápido

Baixe a imagem e rode-a com um único comando:

Rodar o 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

Depois abra http://localhost:8000 e entre com a GOD_PASSWORD que você definiu.

Nota

A imagem inclui ffmpeg, Tesseract OCR, Whisper e Redis embutido. Nenhum serviço adicional é necessário. Gere chaves com openssl rand -hex 32.

Faça o deploy na sua plataforma

Tudo roda a partir da imagem única acima. Escolha a plataforma que você usa.

EasyPanel

1. Project → + Service → App, depois defina Source → Docker Image como ghcr.io/diegoparras/escriba:latest.
2. Adicione suas variáveis de ambiente (veja Configuração).
3. Em Domains, defina Container Port 8000, adicione seu domínio e 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 e o caminho do compose docker-compose.yml (ou cole o arquivo compose no editor web). Defina as variáveis de ambiente e faça o deploy; o aplicativo escuta na porta 8000.

Dokploy

Create Application → GitHub (repositório diegoparras/escriba) com Build Type: Dockerfile, adicione suas variáveis de ambiente, defina o domínio para Container Port 8000 com HTTPS e faça o deploy.

Docker puro

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 um proxy reverso à frente. Com o Caddy, um Caddyfile de duas linhas dá a você HTTPS automático:

Caddyfile

example.com {
    reverse_proxy localhost:8000
}

Configuração mínima

Todas as configurações são variáveis de ambiente. O mínimo recomendado:

.env

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

Se nenhuma senha for definida, uma GOD_PASSWORD aleatória é gerada e exibida nos logs do contêiner ao iniciar. Veja a lista completa em Configuração.

Requisitos

O aplicativo base é leve: uma VPS de 1 núcleo / 2 GB com ~5 GB de disco já é genuinamente suficiente para começar, e o Escriba escala os workers conforme sua CPU. O módulo opcional de anonimização de PII corporativa (Anonimal) é mais pesado — monte-o apenas quando você precisar dele.

Tenha certeza antes de fazer o deploy

Listamos especificações mínimas e recomendadas honestas para cada configuração — aplicativo base, anonimização corporativa e transcrição pesada — para que nunca pareça que “não funciona” por causa da sua máquina. Veja os requisitos completos do sistema →

Guia completo de deploy Todas as opções de configuração