🌟 Project Lumina

Autonomous Academic Orchestration System for the Cognitive Economy of 2026

TechSprint 2026 – Build with Google, Build for Impact

---

🎯 What is Lumina?

Lumina is an AGENTIC AI SYSTEM (not a chatbot!) that acts as an executive-function prosthesis for students. It proactively manages your academic life by:

• 📚 Ingesting syllabi, lectures, and textbooks
• 🔍 Detecting scheduling conflicts and cognitive overload
• 🗓️ Orchestrating your calendar and priorities
• 🛡️ Shielding you from burnout with early warnings

Agentic vs Traditional AI

Traditional Chatbot	Lumina (Agentic AI)
You ask, it answers	It monitors and acts
No memory between sessions	Persistent context
Reactive only	Proactive interventions
Single-turn responses	Multi-step workflows

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Flutter Web/Mobile App                    │
└─────────────────────────────┬───────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                  Firebase Authentication                     │
│                    (Google Sign-In)                          │
└─────────────────────────────┬───────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│              Firebase Cloud Functions (2nd Gen)              │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌────────┐ │
│  │  Syllabus   │ │  Calendar   │ │   Study     │ │Burnout │ │
│  │  Ingestor   │ │Orchestrator │ │  Companion  │ │ Shield │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └────────┘ │
└─────────────────────────────┬───────────────────────────────┘
                              │
          ┌───────────────────┼───────────────────┐
          ▼                   ▼                   ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────┐
│    Firestore    │ │  Cloud Storage  │ │    Google APIs      │
│    Database     │ │   (Documents)   │ │ Calendar • Drive    │
└─────────────────┘ └─────────────────┘ └─────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      Vertex AI Platform                      │
│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────────┐ │
│  │ Gemini 1.5 Pro  │  │ Gemini 1.5 Flash│  │Context Cache │ │
│  │  (Long Context) │  │  (Low Latency)  │  │ (Cost Opt)   │ │
│  └─────────────────┘  └─────────────────┘  └──────────────┘ │
└─────────────────────────────────────────────────────────────┘

---

🤖 The Four Agents

1. Syllabus Ingestor Agent

Goal: Extract structured academic data from unstructured documents
Trigger: User uploads a syllabus (PDF/Image)
Tools: Gemini 1.5 Pro (multimodal), Cloud Storage
Output: Structured JSON with deadlines, grading weights, topics

2. Calendar Orchestrator Agent

Goal: Maintain an optimized, conflict-free academic schedule
Trigger: New deadline detected OR daily sync
Tools: Google Calendar API, Firestore
Output: Synced calendar events with effort estimates

3. Study Companion Agent

Goal: Provide context-aware study assistance
Trigger: User asks about course material
Tools: Gemini 1.5 Pro, Vertex AI Context Caching
Output: Grounded answers from uploaded materials

4. Burnout Shield Agent

Goal: Detect and prevent cognitive overload
Trigger: Nightly scheduled Cloud Function
Tools: Firestore queries, Gemini Flash
Output: Proactive interventions and alerts

---

🛠️ Tech Stack

Layer	Technology
Frontend	Flutter (Web + Mobile)
Backend	Firebase Cloud Functions (2nd Gen)
Database	Cloud Firestore
Storage	Google Cloud Storage
Auth	Firebase Authentication (Google Sign-In)
AI	Gemini 1.5 Pro, Gemini 1.5 Flash
AI Platform	Vertex AI Agent Builder, Context Caching
Integrations	Google Calendar API, Google Drive API

---

🚀 Getting Started

Prerequisites

• Node.js 18+
• Flutter 3.16+
• Firebase CLI
• Google Cloud account with billing enabled

Installation

# Clone the repository
git clone https://github.com/YOUR_USERNAME/project-lumina.git
cd project-lumina

# Install Flutter dependencies
cd lumina-app
flutter pub get

# Install Cloud Functions dependencies
cd ../functions
npm install

# Configure Firebase
firebase login
firebase use --add

Running Locally

# Start Firebase emulators
firebase emulators:start

# In a new terminal, run Flutter app
cd lumina-app
flutter run -d chrome

---

📁 Project Structure

project-lumina/
├── lumina-app/           # Flutter frontend
│   ├── lib/
│   │   ├── features/     # Feature modules
│   │   ├── core/         # Shared utilities
│   │   └── config/       # App configuration
│   └── pubspec.yaml
│
├── functions/            # Firebase Cloud Functions
│   ├── src/
│   │   ├── agents/       # AI agent logic
│   │   └── services/     # API wrappers
│   └── package.json
│
├── firestore/            # Database config
│   ├── firestore.rules
│   └── firestore.indexes.json
│
└── docs/                 # Documentation

---

🏆 Hackathon Information

Event: TechSprint 2026 – Build with Google, Build for Impact
Category: AI for Education
Team: [Your Team Name]

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• Google Cloud for providing the platform
• Firebase team for the amazing developer experience
• Gemini team for the powerful AI capabilities

---

Made with ❤️ for students everywhere