Richard R 4b26531172 chore(worker): migrate compute worker from Redis/BullMQ to NATS JetStream

Replace Redis and BullMQ with NATS JetStream and KV for job queuing and state management
in the compute worker service. Update environment variables, Docker Compose, and documentation
to reflect the new message queue backend. Adjust dependencies and code to use NATS-based
work queue and key-value storage for durable job processing.

This change improves scalability and reliability of distributed compute workloads by leveraging
NATS JetStream's work queue and persistence features. Documentation and configuration examples
are updated to guide deployments using the new backend.

2026-05-20 07:38:03 -06:00

4 KiB

Raw Blame History

📄🔊 OpenReader

OpenReader is an open source, self-host-friendly text-to-speech document reader built with Next.js for EPUB, PDF, TXT, MD, and DOCX with synchronized read-along playback.

Previously named OpenReader-WebUI.

Get started in the docs.

✨ Highlights

🧱 Layout-aware PDF parsing with PP-DocLayoutV3 (ONNX) — structured block detection, cross-page stitching, and geometry-based highlighting for precise read-along sync.
⏱️ Word-by-word highlighting via built-in ONNX Whisper alignment — no external dependencies, runs in-process (COMPUTE_MODE=local) or offloaded to a scalable NATS JetStream-backed worker (COMPUTE_MODE=worker).
⚡ Segment-based read-along for EPUB, PDF, TXT, MD, and DOCX — sentence-aware TTS with cached audio segments, background preloading, and resumable playback.
🎯 Multi-provider TTS — self-hosted OpenAI-compatible servers (Kokoro-FastAPI, KittenTTS-FastAPI, Orpheus-FastAPI) or cloud APIs (OpenAI, Replicate, DeepInfra).
🎧 Audiobook export in m4b/mp3 with resumable chapter processing.
🗂️ Flexible backend — embedded SeaweedFS or S3-compatible storage, SQLite or Postgres, server library import, and device sync.
🐳 Self-host friendly — Docker (amd64/arm64), optional auth, and automatic startup migrations.

🚀 Start Here

Goal	Link
Run with Docker	Docker Quick Start
Deploy on Vercel	Vercel Deployment
Deploy external compute worker	Compute Worker (NATS JetStream)
Develop locally	Local Development
Configure auth	Auth
Configure SQL database	Database and Migrations
Configure object storage	Object / Blob Storage
Configure TTS providers	TTS Providers
Run Kokoro locally	Kokoro-FastAPI
Run KittenTTS locally	KittenTTS-FastAPI
Get support or contribute	Support and Contributing

🧭 Community

Questions and ideas: GitHub Discussions
Bug reports: GitHub Issues
Contributions: open a pull request

📜 License

MIT. See LICENSE.