whatisgithub

What is lumina?

soumen888/lumina — explained in plain English

Analysis updated 2026-07-26

4DartAudience · generalComplexity · 4/5LicenseSetup · hard

In one sentence

Lumina is an app that turns your study PDFs into short, vertical scrolling reels with built-in quizzes and flashcards, making studying feel like scrolling social media.

Mindmap

mindmap
  root((repo))
    What it does
      Turns PDFs into reels
      Quizzes and flashcards
      Spaced repetition
    Tech stack
      Flutter and Dart
      Python backend
      Google Gemini AI
      Firebase Firestore
    Use cases
      Study on your phone
      Test yourself with quizzes
      Review notes as reels
    Audience
      Students
      Self-learners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Upload a textbook PDF and study its key concepts as bite-sized scrolling reels on your phone.

USE CASE 2

Test your understanding with AI-generated quizzes after each reel.

USE CASE 3

Review material over time using built-in spaced repetition flashcards.

USE CASE 4

Listen to study content with offline text-to-speech narration.

What is it built with?

DartFlutterPythonGoogle Gemini AIFirebase Firestore

How does it compare?

soumen888/luminacraftedwebpro/vault-osimranduratbegovic/coban1.0
Stars433
LanguageDartDartDart
Setup difficultyhardhardhard
Complexity4/53/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires setting up a Flutter environment, a Python backend, Google Gemini API access, and a Firebase Firestore project.

Custom non-commercial license, you can use and modify it but likely cannot use it for commercial purposes without permission.

So what is it?

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.

Copy-paste prompts

Prompt 1
Using Flutter and Dart, build a vertical snap-scrolling reel widget that mimics TikTok-style feeds for displaying study content cards.
Prompt 2
Write a Python script that takes a PDF, extracts and chunks the text, and sends it to Google Gemini to generate structured JSON with a concept, example, and quiz question per chunk.
Prompt 3
Implement an SM-2 spaced repetition algorithm in Dart for scheduling flashcard review intervals in a Flutter app.
Prompt 4
Design a Firebase Firestore schema for storing AI-generated study reels with associated flashcards and quiz questions.

Frequently asked questions

What is lumina?

Lumina is an app that turns your study PDFs into short, vertical scrolling reels with built-in quizzes and flashcards, making studying feel like scrolling social media.

What language is lumina written in?

Mainly Dart. The stack also includes Dart, Flutter, Python.

What license does lumina use?

Custom non-commercial license, you can use and modify it but likely cannot use it for commercial purposes without permission.

How hard is lumina to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is lumina for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.