{"id":30726697,"url":"https://github.com/shutootaki/bookwith","last_synced_at":"2025-10-07T07:14:49.182Z","repository":{"id":302092193,"uuid":"936075340","full_name":"shutootaki/bookwith","owner":"shutootaki","description":"BookWith – A New Reading Experience with AI. A next-generation conversational reading platform that goes beyond traditional e-book readers","archived":false,"fork":false,"pushed_at":"2025-08-10T01:55:28.000Z","size":6856,"stargazers_count":209,"open_issues_count":1,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-03T13:45:38.803Z","etag":null,"topics":["epub-reader","fastapi","langchain","llm","openai","python","rag","react","supabase","tyepscript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shutootaki.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-20T13:44:17.000Z","updated_at":"2025-09-03T03:57:35.000Z","dependencies_parsed_at":"2025-08-09T13:17:11.086Z","dependency_job_id":null,"html_url":"https://github.com/shutootaki/bookwith","commit_stats":null,"previous_names":["shutootaki/bookwith"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/shutootaki/bookwith","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shutootaki%2Fbookwith","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shutootaki%2Fbookwith/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shutootaki%2Fbookwith/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shutootaki%2Fbookwith/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shutootaki","download_url":"https://codeload.github.com/shutootaki/bookwith/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shutootaki%2Fbookwith/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278735679,"owners_count":26036659,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["epub-reader","fastapi","langchain","llm","openai","python","rag","react","supabase","tyepscript"],"created_at":"2025-09-03T13:42:53.668Z","updated_at":"2025-10-07T07:14:49.147Z","avatar_url":"https://github.com/shutootaki.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eEnglish\u003c/strong\u003e | \u003ca href=\"README_JA.md\"\u003e日本語\u003c/a\u003e | \u003ca href=\"README_ZH.md\"\u003e简体中文\u003c/a\u003e\n\u003c/p\u003e\n\n# BookWith – A New Reading Experience with AI\n\n\u003e A next-generation conversational reading platform that goes beyond traditional e-book readers\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/AI-Multi_LLM-blue\" alt=\"Multi-LLM AI Powered\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Languages-EN_|_JA_|_ZH-red\" alt=\"Multi-language Support\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Platform-Web-green\" alt=\"Web Platform\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Feature-AI_Podcast-purple\" alt=\"AI Podcast Generation\" /\u003e\n\u003c/p\u003e\n\n## 📖 What is BookWith?\n\nBookWith is an innovative e-book reader where AI becomes your reading partner. By conversing with an AI that fully understands the book's content in real time, BookWith transforms the reading experience from merely _consuming information_ to _creating knowledge_.\n\nIt is more than an e-book reader: BookWith answers your questions, deepens comprehension, and offers new perspectives—your true companion for reading.\n\nhttps://github.com/user-attachments/assets/71ea703a-1213-4942-a355-5dc52f6b505d\n\n## 🎯 Why BookWith?\n\n### Pain Points of Conventional E-Book Readers\n\n- ❌ When you encounter something unclear you have to look it up yourself\n- ❌ No way to check how well you understand what you've read\n- ❌ Hard to discover relationships with content you read in the past\n- ❌ Notes and highlights are scattered and hard to utilize\n\n### How BookWith Solves These Problems\n\n- ✅ AI answers your questions on the spot\n- ✅ Dialogue helps verify and deepen your understanding\n- ✅ Automatically links to your past reading content\n- ✅ Integrates annotations and AI dialogue into solid knowledge\n\n## 🚀 Key Features\n\n### 📚 **AI Reading Assistant**\n\n**An AI partner that fully understands the book's content**\n\n- **Context Awareness**: Grasps the content of the page you are on and answers in context\n- **Instant Answers**: Real-time responses to questions such as \"What does this term mean?\" or \"Summarize the author's argument.\"\n- **Deep Insight Support**: Enables advanced discussions like \"How can this concept be applied today?\"\n- **Full Japanese Support**: Natural Japanese dialogue with rich explanations of technical terms\n\n**Example**\n\n```\nUser: \"If we apply the theory explained in this chapter to a real business scene, what happens?\"\nAI:   \"Applying the innovation theory from Chapter 3 to actual business would…\"\n```\n\n### 🎙️ **AI Podcast Generation**\n\n**Convert book content into conversational podcasts**\n\nhttps://github.com/user-attachments/assets/c4288075-a83c-4b52-a5c0-55b1a79ee252\n\n- **Automatic Script Generation**: Extract key points and convert them into a host-guest dialogue format\n\n  - Optimized for 5-10 minute listenable length\n  - Explains complex topics in an easy-to-understand conversational style\n\n- **High-Quality Audio Synthesis**: Utilize Google Cloud Text-to-Speech's multi-speaker functionality\n\n  - Achieves natural conversation rhythm and intonation\n  - Supports both Japanese and English\n  - Supports multiple languages\n\n- **Seamless Experience**:\n  - Upload a book and automatically generate a podcast\n  - Generated audio is immediately playable\n  - Learn key points while commuting or during movement\n\n**Use Cases**\n\n- When you want to understand the summary of a long novel\n- Check the key points of a business book while commuting\n- Preview the main ideas of a technical book with audio\n\n### 🧠 **Multi-Layer Memory System**\n\n**Innovative memory management that ensures continuity in your reading**\n\n- **Short-Term Memory (latest 5 entries)**\n  - Maintains the current conversation flow\n  - Keeps context even when you turn pages\n- **Mid-Term Memory (summary every 20 entries)**\n  - Condenses key discussion points\n  - Sustains understanding across chapters\n- **Long-Term Memory (vector search)**\n  - Automatically retrieves relevant information from all past dialogues\n  - Links with learning from other books\n- **User Profile**\n  - Learns your interests and preferences\n  - Provides a personalized reading experience\n\n_Example_: Content from an economics book you read a week ago is automatically linked to the marketing book you are reading now.\n\n### 🎨 **Smart Annotation**\n\n**Advanced highlighting that visualizes your thinking**\n\n- **Color Highlights (5 colors)**\n\n  - 🔴 Red: Critical points\n  - 🟡 Yellow: Important concepts\n  - 🟢 Green: Ideas to practice\n  - 🔵 Blue: Questions / To-verify\n\n- **Intelligent Notes**\n\n  - Add detailed comments to highlighted text\n  - Supports Markdown formatting\n\n- **AI Integration**\n  - Automatically prompts AI questions about highlighted passages\n  - AI understands notes and provides related information\n  - Analyzes across multiple highlights\n\n**Use Cases**\n\n- Highlight crucial quotes while reading a paper → AI suggests related studies\n- Mark actionable points in a business book with green → Discuss an implementation plan with AI\n\n### 🔍 **Semantic Search**\n\n**Revolutionary information discovery connected by meaning**\n\n- **Cross-Book Search**\n\n  - Search across multiple books\n  - Past dialogue history is also indexed\n  - Includes annotation content for comprehensive search\n\n- **Automatic Linking**\n  - Suggests past reading content related to what you are reading now\n  - E.g. \"This concept also appeared in the book ○○ you read three months ago…\"\n\n## 👥 Perfect For\n\n### 🎓 **Researchers \u0026 Graduate Students**\n\n- AI proposes related research while you read papers\n- Confirm complex theories on the spot\n- Integrated quote management and literature notes\n\n### 📖 **Book Lovers**\n\n- Ask AI about character relationships in novels\n- Get historical background or cultural context explained\n- Organize discussion points for book clubs\n\n### 🎒 **Students \u0026 Examinees**\n\n- Instant explanations for unclear textbook sections\n- Work through practice problems with AI\n- Integrate content from multiple reference books\n\n### 💼 **Business Professionals**\n\n- Consult on applying business book concepts to your company\n- Summaries of key points and action plan creation\n- Consolidates knowledge from multiple business books\n\n## 📱 How to Use (Detailed Steps)\n\n### Step 1: Upload a Book\n\n1. Drag-and-drop or select an ePub file\n2. It is added to your library and ready to read immediately\n\n### Step 2: Read \u0026 Highlight\n\n1. Select important text while reading\n2. Choose from 5 highlight colors\n3. Add notes if necessary\n4. Ask AI about highlighted content\n\n### Step 3: Chat with AI\n\n1. Ask questions anytime in the chat panel on the right\n2. Select text → \"Ask AI\" to pose context-aware questions\n3. Continue discussions based on past dialogue history\n4. Conversations are automatically saved and indexed\n\n### Step 4: Leverage Your Knowledge\n\n1. Review past learning with semantic search\n2. Integrate knowledge from multiple books\n3. Export your learning for external use\n\n## 💻 Environment \u0026 Technical Specs\n\n- **Supported Devices**\n  - PC (Windows 10+, macOS 10.15+)\n  - Tablets (iPad, Android tablets)\n  - Smartphones (responsive design)\n- **Requirements**\n  - Internet connection (for AI features)\n  - JavaScript enabled\n- **Supported Formats**\n  - ePub 2.0\n  - ePub 3.0\n\n## �️ Local Setup\n\nWant to run BookWith on your own computer?\n\n📋 **[Local Setup Guide](docs/DEVELOPMENT_GUIDE.md)** - Complete installation instructions\n\nThe setup guide includes:\n\n- System requirements and prerequisites\n- Step-by-step installation process\n- How to configure your environment\n- Troubleshooting common setup issues\n- Getting started with your first book\n\n---\n\n## Acknowledgements\n\nThis project is developed as a fork of [Flow](https://github.com/pacexy/flow). We are grateful for the excellent foundation provided by the original project.\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eBookWith – Read deeper. Enjoy more.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003e© 2025 BookWith. All rights reserved.\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshutootaki%2Fbookwith","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshutootaki%2Fbookwith","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshutootaki%2Fbookwith/lists"}