Your 24/7 AI-powered academic advisor for UT Dallas students. Get personalized course recommendations, graduation timelines, and degree planning assistance powered by Google Gemini.

Built for HackAI 2026 | UT Dallas Hackathon

• 🤖 AI Chat Advisor - Ask anything about your degree, courses, or graduation timeline
• 📋 Degree Planning - Semester-by-semester course breakdown with prerequisite tracking
• 📊 Progress Tracking - Real-time graduation progress and credit calculations
• 🔀 What-If Simulator - Explore major changes, minors, and course loads
• 📱 Cross-Platform - Works on iOS, Android, and Web
• 🏫 Real UTD Data - Accurate course requirements for 4 majors and 3 minors

• Node.js installed
• Gemini API key from Google AI Studio

# 1. Install dependencies
npm install

# 2. Create .env file by copying the example
cp .env.example .env

# 3. Add your Gemini API key to .env
# EXPO_PUBLIC_GEMINI_KEY=your-api-key-here

# 4. Start the app
npm start

1. Download Expo Go (free app)
2. Scan the QR code shown in terminal
3. App loads instantly!

├── api/
│   ├── gemini.js          # Gemini AI API integration
│   └── nebula.js          # UT Dallas course data
├── components/
│   ├── Login.js           # Onboarding & profile setup
│   ├── Dashboard.js       # Home screen with progress
│   ├── ChatAdvisor.js     # AI chat interface
│   ├── CourseList.js      # Course recommendations
│   ├── WhatIfSimulator.js # Major/minor scenarios
│   ├── DegreePlan.js      # Semester schedule
│   ├── Profile.js         # Student settings
│   ├── TranscriptUpload.js# PDF transcript upload
│   ├── Auth.js            # Authentication
│   └── Navigation.js      # Tab navigation
├── data/
│   └── requirements.js    # Degree requirements
├── App.js                 # Main entry point
└── package.json

• Frontend: React Native + Expo
• AI: Google Gemini 1.5 Flash
• Data: Real UTD course requirements
• File Upload: expo-document-picker
• UI Components: React Native built-in

Majors:

• Software Engineering
• Neuroscience
• Cybersecurity
• Art

Minors:

• Business
• Data Science
• Mathematics

Create a .env file in the project root:

EXPO_PUBLIC_GEMINI_KEY=your-gemini-api-key-here

The API key is loaded from environment variables and not committed to git for security.

# Start Expo dev server
npm start

# Then choose:
# - Press i for iOS simulator
# - Press a for Android emulator
# - Scan QR code for Expo Go on phone
# - Press w for web browser

# Build for Android
eas build --platform android

# Build for iOS (requires Apple Developer account)
eas build --platform ios

• Enter your name, major, and completed courses
• App calculates your graduation timeline

• "What courses should I take next semester?"
• "When will I graduate?"
• "What if I switch to Cybersecurity?"

• Select your PDF transcript
• Courses are automatically extracted

• View recommended courses
• See what's blocked by prerequisites
• Get full degree plan

• Provides personalized AI responses
• Fallback to demo responses if API unavailable
• Respects rate limits and error handling

• Real UT Dallas course data
• Prerequisite tracking
• Course information (credits, descriptions)