soumen888/lumina

Lumina is an Android app built with Flutter and Dart that turns heavy study materials like textbooks, syllabi, and PDF notes into short, vertical scrolling "reels" similar to TikTok or Instagram. The idea is to make studying feel like scrolling social media instead of slogging through 500-page books. Each reel focuses on one concept at a time, includes a concrete example or code snippet, and ends with a quick question to check if you understood it before moving on. The project has two main parts. A Python backend pipeline takes your uploaded PDFs, extracts the text, chunks it into manageable pieces, and sends those chunks to Google's Gemini AI model. The AI then structures the content into a strict JSON format that defines each reel and quiz question. Once validated, the generated content is uploaded to Firebase Firestore, which serves as the database. The Flutter mobile app connects to Firestore and renders the reels, flashcards, and quizzes on your phone in real time. On the app side, Lumina uses a custom snap-scrolling reel engine that mimics the feel of social media feeds. It includes a spaced repetition flashcard system using the SM-2 algorithm, which is a method for scheduling when to review material so you remember it better over time. The app also has an AI quiz module for testing yourself, and a text-to-speech feature for audio narration that works without using network data. The design follows what the project calls an "Obsidian Scholar" theme, with a glassmorphic visual style. The README is detailed about architecture and data flow but light on practical setup steps within the visible portion. It lists contribution areas like UI polish, prompt engineering, and backend tooling, and notes the project uses a custom non-commercial license. The roadmap mentions future improvements but does not specify timelines. The full README is longer than what was shown.