← all repositories
ahpxex/read-aware

An ebook reader where the AI is the app, not a sidebar

ReadAware builds one agent — with memory, tools, and a plugin system — into a quiet, offline-capable ebook reader.

★502 stars TypeScript AgentsChat Assistants
read-aware
Collecting fresh signals — velocity needs a few days of history.
star history

What it does ReadAware is a free, open-source reader for macOS, Windows, Linux, Android, and iOS that handles EPUB, MOBI, AZW3, FB2, PDF, TXT, HTML, CBZ, and CBR without format conversion. On top of the reading sits a single agent that answers questions in context and builds an evolving memory from your books, highlights, notes, and conversations. It works fully offline with or without AI — the agent is optional, not the admission price.

The interesting bit Most apps bolt AI onto a sidebar; here the agent orchestrates retrieval, context assembly, tool use, and memory, and the interface is a surface it acts on. Plugins and the agent go through the same domain API — every read, write, and event carries its origin (user, plugin, or agent) — so a plugin can add a tool the agent immediately uses. The stated long game: an agent that extends the app for you, through the same contracts plugins are written against.

Key highlights

  • Local-first: SQLite event log as source of truth, memory and search are rebuildable projections — retrieval uses SQLite FTS plus scope, recency, and importance, no vector database required.
  • Sandboxed, permission-gated plugin marketplace: voices, themes, dictionaries, RSS-as-books, and new agent tools.
  • End-to-end encrypted sync via the ReadAware relay or your own WebDAV server; the remote only ever stores ciphertext.
  • Sentence-by-sentence reading mode pitched as calm and ADHD-friendly; vocabulary annotations become review material.
  • A headless CLI (ra) that reads and writes the desktop library and imports books, with or without the app running.
  • AGPL-3.0 overall, but the public plugin API is MIT so third-party plugins can pick any license.

Caveats

  • Windows and Linux builds exist but the README admits broader real-world testing is welcome; iOS is TestFlight-only, no App Store yet.
  • Sync encryption uses a passphrase that cannot be recovered if forgotten — same passphrase required on every device.
  • AI inference is separate from sync encryption: relevant reading context is sent to your chosen model provider, so the “offline” claim applies to reading, not chatting.

Verdict Worth a look if you want a serious local-first reader that treats AI as an optional, well-architected layer rather than a gimmick. Skip it if you just want a minimal EPUB viewer — the agent and plugin machinery is the point here.

Frequently asked

What is ahpxex/read-aware?
ReadAware builds one agent — with memory, tools, and a plugin system — into a quiet, offline-capable ebook reader.
Is read-aware open source?
Yes — ahpxex/read-aware is open source, released under the AGPL-3.0 license.
What language is read-aware written in?
ahpxex/read-aware is primarily written in TypeScript.
How popular is read-aware?
ahpxex/read-aware has 502 stars on GitHub.
Where can I find read-aware?
ahpxex/read-aware is on GitHub at https://github.com/ahpxex/read-aware.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.