whatisgithub

What is reader3?

karpathy/reader3 — explained in plain English

Analysis updated 2026-05-18

3,612PythonAudience · vibe coderComplexity · 1/5Setup · easy

In one sentence

A small self-hosted app that lets you read EPUB books one chapter at a time, made for easily copying text into an AI chat to discuss what you just read.

Mindmap

mindmap
  root((reader3))
    What it does
      Read EPUB books
      One chapter at a time
      Copy text to LLM
    Tech stack
      Python
      uv
    Use cases
      Discuss books with AI
      Personal reading tool
      Local book library
    Audience
      Vibe coders
      Hobbyist readers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Read an EPUB book chapter by chapter in a local web browser.

USE CASE 2

Copy chapter text easily to discuss or summarize with an AI assistant.

USE CASE 3

Keep a small personal library of EPUB books served from your own computer.

What is it built with?

Pythonuv

How does it compare?

karpathy/reader3pgadmin-org/pgadmin4markfzp/act-plus-plus
Stars3,6123,6113,615
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity1/53/55/5
Audiencevibe coderdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Built quickly for personal use and not actively maintained by the author.

No license information is stated in the README.

So what is it?

Reader3 is a small, self-hosted web app for reading EPUB books one chapter at a time on your own computer. The main idea behind it is convenience when reading alongside an AI assistant: because it shows one chapter at a time, you can easily select the text, copy it, and paste it into a conversation with a language model to discuss, summarize, or ask questions about what you just read. To use it, you point it at an EPUB file from the command line. It processes the book and registers it to a local library folder. Then you start a local web server and visit it in your browser to see your library and read. Adding more books means running the same command with different files, removing a book means deleting its folder. The project uses uv, a Python tool that handles dependencies without requiring a separate installation step. The README gives a short example using a free copy of Dracula downloaded from Project Gutenberg. The author, Andrej Karpathy, describes this as something he built quickly for personal use, roughly 90 percent written with AI assistance, and shared as an example of how easy it is to build small tools this way. He is explicit that he does not intend to maintain or improve it. The code is provided as-is for others to read, run, or modify however they like.

Copy-paste prompts

Prompt 1
Show me the command to add an EPUB file to my reader3 library and start the local server.
Prompt 2
Explain how reader3 uses uv to manage its Python dependencies.
Prompt 3
Walk me through reading a chapter from reader3 and pasting it into a conversation with an AI.
Prompt 4
How would I remove a book from my reader3 library?

Frequently asked questions

What is reader3?

A small self-hosted app that lets you read EPUB books one chapter at a time, made for easily copying text into an AI chat to discuss what you just read.

What language is reader3 written in?

Mainly Python. The stack also includes Python, uv.

What license does reader3 use?

No license information is stated in the README.

How hard is reader3 to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is reader3 for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.