Chytai

Читалка книжок у стилі Kindle, яка пояснює виділений текст за допомогою Claude прямо під час читання.

Виділяєш слово, фразу чи абзац, натискаєш «Пояснити», і пояснення з'являється саме в контексті цієї книжки. Модель бачить виділений фрагмент, кілька абзаців до і після, назву книжки й розділу.

Chytai має дві рівноправні версії з одним інтерфейсом:

• Веб-версія (PWA) для телефона й будь-якого браузера. Вона оптимізована під читання з телефона, і саме нею ми користуємося щодня. Працює на https://chytai.fly.dev.
• Десктопна версія для macOS (Electron), яка вміє також читати книжки з локальних папок та iCloud.
• Застосунок для iPhone (app/, Expo): та сама веб-читалка в нативній оболонці, ставиться через TestFlight, оновлюється без ревʼю Apple. Як це влаштовано і як зібрати: app/README.md.

Можливості

• Типографіка як у Kindle: шрифт Literata, вирівнювання по ширині, переноси, колонтитул із назвою книжки. У налаштуваннях можна вибрати шрифт і поля сторінки. Розмір шрифту (A− / A+) запам'ятовується для кожної книжки окремо.
• Пояснення: виділи текст і натисни Пояснити або Спитати…, щоб поставити своє питання. Пояснення короткі, наскільки дозволяє фрагмент; кнопка «Детальніше» під відповіддю розгортає його, а в полі нижче можна дописати уточнення. Пояснені місця підсвічуються в тексті, і тап по підсвітці відкриває відповідну картку.
• Бібліотека: зверху нещодавно відкриті книжки, найсвіжіші першими, нижче всі книжки за авторами, з пошуком і фільтром мови.
• Позиція в кожній книжці запам'ятовується окремо для кожного читача.
• Виноски: після переходу за посиланням типу [230] з'являється кнопка «← Назад», яка повертає туди, де читав.
• PDF «Як книжка»: читалка витягує текст із PDF, прибирає колонтитули й номери сторінок і показує його з тією самою типографікою, що й EPUB. Кнопка «Оригінал PDF» повертає оригінальну верстку.

Веб-версія на телефоні

Сервер server/index.js віддає інтерфейс із src/renderer/ і невеликий API, а src/renderer/web-bridge.js замінює місток Electron на HTTP-запити. Ключ Claude API лежить лише на сервері; телефон його ніколи не бачить. Бібліотека спільна для всієї родини, а позиції й налаштування в кожного свої (вхід за ім'ям і спільним паролем).

На iPhone відкрий адресу в Safari, увійди і додай на екран «Додому» (Поділитися → На Початковий екран), і далі Chytai відкривається як застосунок.

Як читати на телефоні:

• Під час читання панель кнопок схована, і текст займає весь екран. Тап по сторінці показує панель, прокрутка ховає її знову. Тема (як у системі, світла, темна, сепія) вибирається в налаштуваннях; типово вона йде за світлим чи темним режимом телефона.
• Книжка читається безперервною прокруткою. Якщо зручніше гортати сторінки (свайп або тап по краю), це вмикається в налаштуваннях.
• Виділяєш скільки треба (пояснення саме не стартує), потім тиснеш «Пояснити» в панельці внизу екрана. Пояснення відкриваються в нижній частині екрана і ховаються кнопкою «Сховати».
• Книжки додаються кнопкою «Додати книжки…» у бібліотеці (EPUB і PDF, можна кілька файлів за раз). Інші формати спершу конвертуються на Mac через Calibre.
• Кнопка «Керувати» в бібліотеці (лише для родини) дає виправити назву й автора книжки (виправлення зберігається в state.json, файл не змінюється; «Як у файлі» повертає метадані з файлу) і видалити книжку з підтвердженням. Видалення прибирає файл для всіх разом із позиціями читання в ній.

Демо-режим для гостей

Посилання /demo (є також на сторінці входу) відкриває читалку без пароля: одна демо-книжка, без завантажень і видалень, із денним лімітом пояснень, щоб ключ Claude не можна було вичерпати. Позиції та налаштування гостя живуть лише в пам'яті сервера.

• Вбудована демо-книжка: Остап Вишня, «Мисливські усмішки» разом із «Моєю автобіографією» (тексти з УкрЛіб, зібрані в EPUB) у demo/. Будь-який EPUB/PDF у /data/demo на томі має пріоритет над вбудованим.
• Член родини може вибрати іншу книжку з бібліотеки в налаштуваннях («Книжка для демо-режиму»); варто обирати лише те, що можна показувати публічно.
• Ліміти: GUEST_EXPLAIN_LIMIT пояснень на гостя за день (типово 15), GUEST_EXPLAIN_TOTAL на всіх гостей (типово 300); GUEST_MODE=off вимикає демо зовсім.

Статистика для родини

Сторінка /admin (кнопка «Статистика» в налаштуваннях) показує, хто читає, скільки книжок у бібліотеці і скільки пояснень використано: сьогодні, за тиждень, усього, по днях і по моделях, із приблизною вартістю за тарифами API. Лічильники живуть у state.json (stats), гості на сторінку не потрапляють. День рахується за STATS_TZ (типово Europe/Kyiv).

Запуск локально

cp .env.example .env   # ANTHROPIC_API_KEY, READER_PASSWORD, READER_SECRET
npm install
npm run web            # http://localhost:8080

Деплой на Fly.io

Застосунок описано у fly.toml (книжки й позиції лежать на томі /data):

fly launch --copy-config --no-deploy   # один раз
fly secrets set ANTHROPIC_API_KEY=… READER_PASSWORD=… READER_SECRET=…
fly deploy
node scripts/upload-books.mjs https://chytai.fly.dev "~/Library/Mobile Documents/com~apple~CloudDocs/Books"

Машина засинає, коли нею ніхто не користується, і прокидається на перший запит за кілька секунд.

This is the beginning of the README. Read the rest at the original. Read the full README ↗