🧊 Smoothie Reader (Reader3)

"When technology is democratized by AI, aesthetics and human-centric design become the ultimate differentiators."

Inspired by Andrej Karpathy's minimalist reader prototype, Smoothie Reader is a locally deployed AI-powered e-book reader with built-in word lookup, AI translation & chat, TTS reading, and highlight notes — designed for deep reading.

📖 Built-in sample book: The repository includes "Meditations" by Marcus Aurelius (via Project Gutenberg), ready to explore after cloning.

_{Your personal library at a glance}

✨ Key Features

🔍 Intuitive Discovery: Highlight any text to reveal the action bar. Built-in support for ECDICT (English) and Chinese offline dictionaries.
🤖 AI-Powered Reading:
- Inline Translation: High-quality, contextual translations elegantly embedded below the original text.
- AI Companion: A sidebar AI assistant supporting streaming dialogue and multi-turn memory for deep engagement.
- Broad Compatibility: Built-in support for OpenAI, Anthropic, Gemini, DeepSeek, Grok, Alibaba Cloud Bailian, Volcengine, Tencent Hunyuan, MiniMax, Moonshot, SiliconFlow, Cerebras, SambaNova, Groq, Mistral, DeepInfra, Together AI, OpenRouter, Zhipu AI, and ModelScope — 20 AI providers in total, plus custom OpenAI-compatible endpoints.

_{Selection toolbar · Inline translation · AI companion sidebar}

🔊 TTS Reading: Powered by Edge-TTS with multiple high-quality Chinese and English voices.
✏️ Highlights & Notes: 5-color highlighting, inline annotations, and bookmarks — all stored in your browser's localStorage.

_{Three-column reading: TOC navigation · Immersive text · Multi-color highlights}

🎨 Minimalist Aesthetics: 6 curated themes and a flexible 3-column layout (TOC / Content / AI), optimized for all devices.

_{Themes, typography, dictionaries, AI models — all in one panel}

🚀 Quick Start

This project uses uv to manage the Python environment and dependencies.

1. Install uv

Ensure Python 3.10+ is available, then install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Import a Book & Launch

# Import an EPUB e-book
uv run reader3.py your_book.epub

# Start the server
uv run server.py

Open your browser at: 👉 http://localhost:8123

3. Configure AI

Enter the reading interface, click Settings in the top-left corner, and configure your AI Provider and API Key (e.g., get a free Gemini Key).

Tip

🚀 Easter Egg: Anywhere on the page, enter ↑ ↑ ↓ ↓ ← → ← → B A (Konami Code) to unlock the hidden Advanced AI Routing Panel.

🛡️ Privacy

Local First: No data leaves your device unless you explicitly trigger an AI or TTS request.
No Account Required: Your data is stored only in your browser's localStorage.

📚 User Guide

For detailed configuration (offline dictionaries, multi-device access, port settings), see the User Guide.

📄 License

MIT License

FilesExpand file tree

README.en.md

Latest commit

History