No description
Find a file
Richard R 5403aa00cc refactor(compute-worker): modularize operation contracts and API, update protocol naming
- Move operation contracts from api/contracts to operations/contracts for clearer separation
- Delete legacy API modules: contracts.ts, operation-keys.ts, public-operation.ts
- Add new modular files: compute-operation.ts, http-hooks.ts, routes.ts, operations/keys.ts, operations/reconciliation.ts
- Refactor all imports to use new operations/contracts and keys modules
- Rename protocol types from PublicOperation to ComputeOperation for clarity
- Update OpenAPI schema and all references to use ComputeOperation/Event naming
- Extract whisper decoder helpers to inference/whisper/decoder.ts
- Add new infra: nats-session.ts for NATS session management
- Update tests and storage logic to use new contracts and keys modules
- Refactor worker loop and orchestrator to use modular job definitions
- Update client and protocol in src/lib/server/compute-worker to use new ComputeOperation types

This refactor modularizes compute-worker operation logic, clarifies type naming, and improves maintainability by separating contracts, keys, and reconciliation logic. No breaking changes to external API, but all internal references and tests are updated for the new structure.
2026-06-13 05:04:24 -06:00
.github Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00
compute-worker refactor(compute-worker): modularize operation contracts and API, update protocol naming 2026-06-13 05:04:24 -06:00
docker/entrypoint-migration-tools feat(build): improve Docker image layering and embed migration/worker tools 2026-06-03 14:08:33 -06:00
docs-site Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00
drizzle Refactor user data cleanup and TTS storage flows (#105) 2026-06-07 13:33:20 -06:00
public update(auth): enhance rate limiting with device/IP backstops and improve UI 2026-01-25 14:38:31 -07:00
scripts refactor(compute-worker): migrate compute logic to modular architecture 2026-06-12 14:07:15 -06:00
src refactor(compute-worker): modularize operation contracts and API, update protocol naming 2026-06-13 05:04:24 -06:00
tests refactor(compute-worker): migrate compute logic to modular architecture 2026-06-12 14:07:15 -06:00
.dockerignore Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00
.env.example docs(security): update secret key generation instructions to use base64 encoding 2026-06-07 14:07:45 -06:00
.gitattributes Fix check mark in SettingsModal 2025-02-11 21:31:11 -07:00
.gitignore refactor(compute-worker): migrate compute logic to modular architecture 2026-06-12 14:07:15 -06:00
.npmrc chore: add .npmrc for npm configuration 2026-05-21 11:18:41 -06:00
Dockerfile refactor(compute-worker): migrate compute logic to modular architecture 2026-06-12 14:07:15 -06:00
drizzle.config.pg.ts Refactor authentication schema and database handling 2026-02-15 12:49:23 -07:00
drizzle.config.sqlite.ts Refactor authentication schema and database handling 2026-02-15 12:49:23 -07:00
empty-module.ts chore(lint): fix eslint violations in worker config and e2e tests 2026-05-21 21:44:58 -06:00
eslint.config.mjs Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00
LICENSE Initial commit 2025-01-18 00:36:14 -07:00
next.config.ts Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00
package.json Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00
playwright.config.ts Refactor user data cleanup and TTS storage flows (#105) 2026-06-07 13:33:20 -06:00
pnpm-lock.yaml Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00
pnpm-workspace.yaml Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00
postcss.config.mjs First push 2025-01-18 04:58:57 -07:00
README.md docs(intro): clarify open-source status and multilingual support in introduction 2026-06-06 12:19:28 -06:00
tailwind.config.ts Redesign: shared UI design system + app-wide migration (#96) 2026-06-01 16:17:12 -06:00
tsconfig.json Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00
vercel.json Refactor user data cleanup and TTS storage flows (#105) 2026-06-07 13:33:20 -06:00
vitest.config.ts Refactor PDF parsing and rendering logic; migrate to compute-worker protocol 2026-06-12 13:43:33 -06:00

GitHub Release License Docs Playwright Tests Docs Check

GitHub Stars GitHub Forks Discussions

📄🔊 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 multilingual, 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 ONNX Whisper alignment through the compute worker control plane (NATS JetStream-backed).
  • 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).
  • 🌐 Multilingual support — choose a document language for language-aware narration and highlighting. Available languages depend on the configured TTS provider and voice.
  • 🎧 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), built-in auth/session support, 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

📜 License

MIT. See LICENSE.