GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com โ€” GitHub - codedogQBY/ReadAny: AI-powered cross-platform e-book reader with semantic search, RAG chat, local vector store, notes, TTS, and WebDAV sync.

BranchesTags
Open more actions menu

Latest commit

 

History

1,181 Commits
1,181 Commits

Folders and files

NameName
Last commit message
Last commit date
.agents/skills
.agents/skills
 
 
.claude
.claude
 
 
.expo
.expo
 
 
.github/workflows
.github/workflows
 
 
assets
assets
 
 
docs
docs
 
 
packages
packages
 
 
patches
patches
 
 
scripts
scripts
 
 
website
website
 
 
.gitignore
.gitignore
 
 
.npmrc
.npmrc
 
 
EPUB_CONVERSION_PLAN.md
EPUB_CONVERSION_PLAN.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
README_CN.md
README_CN.md
 
 
biome.json
biome.json
 
 
eas.json
eas.json
 
 
package.json
package.json
 
 
pnpm-lock.yaml
pnpm-lock.yaml
 
 
pnpm-workspace.yaml
pnpm-workspace.yaml
 
 
skills-lock.json
skills-lock.json
 
 
tsconfig.json
tsconfig.json
 
 

Repository files navigation

ReadAny Logo

ReadAny

Local-first AI e-book reader for desktop and mobile

"Why do I forget what I read? Why are my notes scattered? Why can I only search by keywords?"

ReadAny helps you ask questions about books, find ideas by meaning, and build a private reading knowledge base with RAG chat, semantic search, highlights, TTS, and WebDAV sync.

Release Stars License Platform Chinese


๐Ÿš€ v2.0 Update: Mobile apps (iOS/Android) now available! See Mobile section below.

AI-Native Reading Workflow

  • Chat with your library - Ask questions about the current book or selected passages, with answers grounded in your reading context
  • Find ideas semantically - Hybrid vector retrieval + BM25 search helps you find concepts even when the exact keyword is missing
  • Keep knowledge private - Local embeddings and a local vector store keep your books, highlights, and notes offline-capable
  • Use your preferred model - Connect OpenAI, Claude, Gemini, Ollama, DeepSeek, or custom-compatible providers

Why ReadAny?

Problem Traditional Readers ReadAny
Search content Keywords only Semantic search that understands your intent
Ask questions Find answers yourself AI answers directly + locates sources
Take notes Manual copy-paste Select to highlight, one-click export
Knowledge management Scattered notes Unified management, multi-format export
Privacy Upload to cloud Local vector store, fully offline capable

Comparison with Alternatives

Feature ReadAny Calibre KOReader Apple Books
AI Chat โœ… โŒ โŒ โŒ
Semantic Search (RAG) โœ… โŒ โŒ โŒ
Local Vector Store โœ… - - โŒ
TTS (Text-to-Speech) โœ… โŒ Limited Limited
Reading Stats โœ… โŒ โŒ Limited
WebDAV Sync โœ… โŒ โŒ โŒ
Skills System โœ… โŒ โŒ โŒ
Format Support 10+ 15+ 10+ 2
Note Export 5 formats Limited Limited Limited
Open Source โœ… โœ… โœ… โŒ

Screenshots

Hero

ReadAny Hero

AI-Powered Chat

AI Chat - Desktop AI Chat - Mobile

Notes & Highlights

Notes - Desktop Notes - Mobile

Text-to-Speech

TTS - Desktop TTS - Mobile

Reading Statistics

Stats - Desktop Stats - Mobile

Cross-Device Sync

Sync - Desktop Sync - Mobile

Core Features

๐Ÿค– AI-Powered Reading

  • Intelligent Chat - Ask questions about your books, AI knows your position, selected text, and highlights
  • Semantic Search - Beyond keywords, vector retrieval + BM25 hybrid search
  • Instant Translation - AI translation or DeepL, 19 languages supported
  • Multiple AI Providers - OpenAI, Claude, Gemini, Ollama, DeepSeek
  • Skills System - Built-in skills (summarizer, concept explainer, character tracker, etc.) + create custom skills

๐Ÿ“ Annotation & Knowledge Management

  • 5-Color Highlights - Yellow/Green/Blue/Pink/Purple, hover to preview notes
  • Markdown Notes - Rich text editor with toolbar, WYSIWYG
  • Multi-format Export - Markdown, HTML, JSON, Obsidian, Notion

๐Ÿ”Š Text-to-Speech (TTS)

  • Multiple Engines - Edge TTS, Browser TTS, DashScope (้€šไน‰ๅƒ้—ฎ)
  • Voice Selection - 100+ voices in multiple languages
  • Speed Control - Adjustable playback speed
  • Background Playback - Listen while doing other things

๐Ÿ“Š Reading Statistics

  • Reading Heatmap - Visualize your reading habits like GitHub contributions
  • Trend Charts - Track daily/weekly/monthly reading time
  • Streak Tracking - Longest consecutive reading days
  • Book Statistics - Time spent per book, completion rate

โ˜๏ธ Cross-Device Sync

  • WebDAV Support - Sync your library, highlights, and notes across devices
  • Auto Sync - Automatic background synchronization
  • Conflict Resolution - Smart merge for concurrent edits

๐Ÿ“š Multi-Format Support

EPUB ยท PDF ยท MOBI ยท AZW ยท AZW3 ยท FB2 ยท FBZ ยท CBZ ยท TXT ยท UMD

TXT and UMD are imported by converting them to EPUB for reading, notes, search, and sync.

๐ŸŽจ Customizable Experience

  • 5 font themes (CJK optimized)
  • Light/Dark mode
  • Paginated/Continuous scroll
  • Keyboard shortcuts
  • English/Chinese interface

Quick Start

Download

Platform Download
macOS (Apple Silicon) Download .dmg
macOS (Intel) Download .dmg
Windows Download .msi
Linux Download .AppImage
iOS Join TestFlight
Android Download .apk

Homebrew (macOS)

brew tap codedogQBY/readany
brew install --cask readany

3 Steps to Get Started

  1. Import Books - Drag and drop files into library
  2. Start Reading - Double-click to open, immersive experience
  3. Configure AI (Optional) - Settings โ†’ AI โ†’ Enter API Key

Mobile Apps

ReadAny is now available on mobile devices!

Expo (React Native) Version:

# Clone and setup
git clone https://github.com/codedogQBY/ReadAny.git
cd ReadAny
pnpm install

# Install/run the development build on iOS
pnpm expo:ios

# Install/run the development build on iOS Simulator
pnpm expo:ios:simulator

# Install/run the development build on Android
# Start an Android emulator first, or connect a device.
pnpm expo:android

# Start Metro for the installed development build
pnpm expo:start

Mobile development uses an Expo development build with expo-dev-client, not Expo Go. Expo Go cannot load ReadAny's native modules and app configuration. Use pnpm expo:ios, pnpm expo:ios:simulator, or pnpm expo:android the first time, or whenever native dependencies/configuration change, then use pnpm expo:start for daily JS debugging in the installed ReadAny development app.

For simulators, use pnpm expo:ios:simulator on iOS. For Android, start an Android emulator first, then run pnpm expo:android.

Mobile app source lives in packages/app-expo.

AI Configuration

Provider Get API Key
OpenAI platform.openai.com
Anthropic Claude console.anthropic.com
Google Gemini aistudio.google.com
Ollama / DeepSeek Local or custom endpoint

Tech Stack

Layer Technology
Desktop Tauri 2 (Rust)
Mobile Expo (React Native) + Tauri Mobile
Frontend React 19 + TypeScript
Build Vite 7
Styling Tailwind CSS 4 + Radix UI
State Zustand
Database SQLite
E-Book foliate-js
AI/LLM LangChain.js + LangGraph
Embeddings Transformers.js

Development

# Clone
git clone https://github.com/codedogQBY/ReadAny.git
cd ReadAny

# Install
pnpm install

# Dev (Desktop)
pnpm tauri dev

# Dev (Mobile - Expo development build, not Expo Go)
# First install/run the native development build:
pnpm expo:ios
pnpm expo:ios:simulator
pnpm expo:android

# Then start Metro for the installed development app:
pnpm expo:start

# Build
pnpm tauri build

Mobile development uses expo-dev-client, so Expo Go is not supported. Re-run pnpm expo:ios, pnpm expo:ios:simulator, or pnpm expo:android after changing native dependencies, app.config.js, permissions, schemes, or build plugins.

Requirements: Node.js โ‰ฅ18, pnpm โ‰ฅ9, Rust (for Tauri), plus Xcode for iOS or Android Studio/SDK for Android mobile development.


Roadmap

  • Mobile apps โ€” iOS and Android versions available
  • TTS (Text-to-Speech) โ€” Edge TTS, multiple voices
  • Reading Statistics โ€” Heatmap, trends, streaks
  • Skills System โ€” Built-in + custom AI skills
  • WebDAV Sync โ€” Cross-device synchronization
  • More AI models (Qwen, GLM, Llama)
  • PDF reflow/re-render
  • Plugin system
  • Cloud sync (official service)

Contributing

Contributions welcome! Bug reports, feature requests, pull requests all appreciated.

  1. Fork โ†’ 2. Branch โ†’ 3. PR

Please run pnpm lint before submitting to ensure code style consistency.


License

GPL-3.0 ยฉ 2024 ReadAny Team

This project is open source under the GNU General Public License v3.0. You are free to use, modify, and distribute the code, but any derivative works must also be open source under the same license.

Note: While the source code is freely available, the official app store versions may be offered for a fee to support ongoing development and cover certificate costs. You can always build the app yourself at no cost.


Acknowledgments

  • foliate-js - E-book rendering engine
  • Tauri - Cross-platform desktop framework
  • Expo - React Native development platform
  • LangChain.js - AI orchestration framework
  • Radix UI - Accessible UI components
  • Lucide - Icon library

Community

Thanks to linux.do โ€” a vibrant Chinese tech community where you can learn about AI, development, and more.


Made with โค๏ธ by the ReadAny Team

๐Ÿ’ฌ Discussions โ€ข ๐Ÿ› Issues

ๅฐ็บขไนฆ็พค ๅพฎไฟก็พค

โ˜• Support the Project

If you find ReadAny helpful, consider buying me a coffee to support ongoing development!

ๅพฎไฟก่ตž่ต็  ๆ”ฏไป˜ๅฎๆ”ถๆฌพ็ 

Dining Table on Afdian


Star History

Star History Chart

About

AI-powered cross-platform e-book reader with semantic search, RAG chat, local vector store, notes, TTS, and WebDAV sync.

codedogqby.github.io/ReadAny/

Topics

aianthropicebook-readerembeddingsepub-readerexpoknowledge-managementllmlocal-firstollamaopenairagreactreact-nativesemantic-searchsqlitetaurittstypescriptvector-search

Resources

Readme
License
Activity

Stars

3.0k stars

Watchers

7 watching

Forks

244 forks
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402503 โ€” GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800ร—600. No cookies required.