v0.1.0-alpha

readerike v0.1.0-alpha

Primeira versão pública do readerike — transcrição de vídeos local e privada, sem nenhum dado enviado para a nuvem.

---

O que é o readerike?

Faça upload de um vídeo e receba a transcrição em texto, SRT e JSON. Tudo roda na sua máquina usando OpenAI Whisper + FFmpeg.

---

Funcionalidades

• Interface web — arraste um vídeo, acompanhe o progresso em tempo real via WebSocket e leia a transcrição sincronizada com o vídeo
• API REST — endpoints para criar, listar, consultar, deletar jobs e baixar transcrições em JSON, TXT ou SRT
• CLI — transcreva diretamente pelo terminal com readerike
• 100% local — nenhum dado sai da sua máquina
• Modelos Whisper — tiny, base, small, medium e large
• Docker Compose — sobe tudo com um único comando

---

Como rodar

Pré-requisito: Docker Desktop instalado.

git clone https://github.com/rikemorais/readerike.git
cd readerike
mkdir -p data
docker compose up --build

Quando estiver pronto:

Serviço	URL
Interface web	http://localhost:3000
API / Swagger	http://localhost:8000/docs

---

Modelos disponíveis

Modelo	RAM	Velocidade	Qualidade
tiny	~1 GB	⚡⚡⚡	★★☆
base	~1 GB	⚡⚡⚡	★★★
small	~2 GB	⚡⚡	★★★★
medium	~5 GB	⚡	★★★★★
large	~10 GB	🐢	★★★★★

O padrão é base. Para usar outro modelo:

WHISPER_MODEL=small docker compose up

---

Arquitetura

O projeto segue Clean Architecture (Ports & Adapters), mantendo a lógica de negócio completamente desacoplada de frameworks e tecnologias externas.

---

⚠️ Esta é uma versão alpha — pode conter bugs e a API ainda pode mudar antes da v1.0.0.

What's Changed

• feat: add REST API, WebSocket and Next.js frontend by @rikemorais in #1

Full Changelog: https://github.com/rikemorais/readerike/commits/v0.1.0-alpha