reader3 README

The project's README from github.com/karpathy/reader3. As one markdown file: README.md.

reader 3

reader3

A lightweight, self-hosted EPUB reader that lets you read through EPUB books one chapter at a time. This makes it very easy to copy paste the contents of a chapter to an LLM, to read along. Basically - get epub books (e.g. Project Gutenberg has many), open them up in this reader, copy paste text around to your favorite LLM, and read together and along.

This project was 90% vibe coded just to illustrate how one can very easily read books together with LLMs. I'm not going to support it in any way, it's provided here as is for other people's inspiration and I don't intend to improve it. Code is ephemeral now and libraries are over, ask your LLM to change it in whatever way you like.

Usage

The project uses uv. So for example, download Dracula EPUB3 to this directory as dracula.epub, then:

uv run reader3.py dracula.epub

This creates the directory dracula_data, which registers the book to your local library. We can then run the server:

uv run server.py

And visit localhost:8123 to see your current Library. You can easily add more books, or delete them from your library by deleting the folder. It's not supposed to be complicated or complex.

License

MIT

reader3 (karpathy/reader3)

Searching Database…

3.9K ·GitHub
Что это такое?Легковесный self-hosted EPUB-читалка от Andrej Karpathy, который показывает книгу по одной главе за раз — удобно скопировать главу в LLM и читать вместе с ним.
Так это сайт, десктопное приложение или что-то для моей электронной книги?Вы запускаете его сами: это небольшое self-hosted веб-приложение — поднимаете сервер на своём компьютере, открываете localhost:8123 в браузере, и он показывает ваши книги в виде библиотеки.
Как добавить в него первую книгу?Проект использует uv: скачайте EPUB в папку проекта (например, как dracula.epub), запустите шаг ingest, чтобы зарегистрировать книгу — появится папка draculadata, — затем запустите сервер и откройте localhost:8123.
Что должно быть установлено перед запуском?Только Python-инструменты через uv — весь проект написан на Python и работает через uv, а других зависимостей в README не названо.
Это готовый поддерживаемый продукт?Нет. Karpathy сделал его как быструю иллюстрацию, на 90% vibe coded, и говорит, что не будет поддерживать или улучшать его — он предоставлен как есть, чтобы вдохновить других.
Как работает часть с LLM — мне нужен API-ключ?Нет. Никакой встроенной интеграции с LLM нет — вы сами копируете текст главы в любимую LLM и читаете вместе с её ответами.
Где взять EPUB-книги для чтения?В README предлагается Project Gutenberg, где много бесплатных EPUB; любой EPUB, положенный в папку проекта, можно обработать тем же способом.
Как добавить книги в библиотеку или убрать их оттуда?Дополнительные EPUB обрабатываются так же, как первая; каждая книга живёт в своей папке (например draculadata), и удаление этой папки убирает книгу из библиотеки.
Зачем Karpathy это сделал?Как быструю иллюстрацию того, как легко можно читать книги вместе с LLM — проект на 90% vibe coded, он задуман как вдохновение, а не как поддерживаемый продукт.
Creator
karpathy
Size
0.3 MB
Stars
3.9K
Updated
CommitNov 18
Age
10mo
Commits · 90 Days