Skip to content

Final Ninja: Your Smart AI Study Companion for Finals

Notifications You must be signed in to change notification settings

mxxct4git/Final-Ninja

Repository files navigation

Inspiration

When finals approach, many students fall into the "procrastination-anxiety-more procrastination" cycle. The real issue isn’t a lack of study materials—it’s a lack of motivation and clear planning. Our goal is to help students go from "I should study" to "I’m actually studying"—and doing so efficiently.

🎮 The Power of Gamification: Apps like Duolingo make learning addictive with streaks and rewards. We want to bring that same energy to finals prep with achievements + leaderboards to fuel motivation.

🤖 AI That Does More Than Just Chat: Assistants like Manus AI don’t just think, they act by handling browser tasks, organizing data, and more. We want our AI to not just plan your study sessions, but also fetch your materials, highlight key points, and create quizzes, so you can focus on learning.

🧠 ADHD-Friendly Reading Mode: Many students struggle with focus. Our tool will include custom reading modes to make learning materials easier to digest.

Introduction

Final Ninja is a desktop AI study buddy designed for finals season. It blends AI-driven planning with fun, interactive gamification to make studying feel like leveling up in a game! From auto-summarizing study materials to generating quizzes, creating focus playlists, and tracking study progress with friends, Final Ninja makes sure your finals prep is smart, engaging, and stress-free.

Demo Video

Links

What Makes It Special?

Traditional study tools → Boring, rigid, one-size-fits-all.
Final Ninja → Smart, interactive, and fun!

AI That Actually Gets Things Done
With ChatGPT + Selenium, our AI understands your study needs and automates tasks like collecting key notes and organizing study materials all in one place.

🎮 Gamified Experience
Your desktop ninja pet tracks progress, reminds you of tasks, and chats with you. Unlock new skins and achievements as you study—making it a motivating, personal experience.

💡 Inclusive Design
Features like ADHD-friendly fonts, dynamic reading modes, personalized music playlists, and study companion modes ensure that every student finds their optimal study flow.

Core Features

1. Smart AI Study Agent

📌 AI-Powered Study Planner : Tell Final Ninja "48-hour Python crash course," and it will log in to your course portal, extract key materials, highlight frequent exam topics, and create a last-minute survival guide.

📝 Instant Quiz Generator : After studying, test yourself with AI-generated quizzes. Wrong answers? Get auto-explained solutions like having a personal tutor!

2. Fun Study Enhancements

🎵 Custom Study Playlists : Type “battle jazz” or “ninja study room,” and the AI will generate a Spotify playlist to match your vibe. Need a break? Switch to meditation white noise.

Pomodoro Timer + Study Reminders: A built-in 30-minute timer reminds you to take breaks, because balance is key!

3. Personalized Learning Modes

🧠 ADHD-Friendly Focus Mode: Automatically switches to focus mode on study pages:

  • Warm beige backgrounds for reduced eye strain
  • Readable fonts for better clarity
  • Auto-blurring distractions to improve concentration

📊 Leaderboard & Study Battles: Compete with friends on daily study time rankings—fueling motivation with friendly rivalry!

Tech Implementation

1. Core Architecture

🎮 Frontend Interaction: Built with Godot, featuring an interactive ninja pet for a fun, game-like interface. It supports voice & text commands to interact with the AI.

🧠 AI Logic Layer: Powered by OpenAI GPT API + LangChain, breaking down complex study plans into step-by-step tasks.

🖥 Automation Layer: Uses Selenium to log in to course portals, scrape materials, highlight key points, and apply adhd display mode. BeautifulSoup parses webpages for relevant content. Spotify API generates study playlists based on keywords.

Future Expansions

🚀 Social Study Features: Multiplayer study rooms, real-time battles, voice & video study sessions for accountability.

🤖 Advanced AI Support: Auto-updates Moodle progress, tracks deadlines, and sends personalized study reminders via email.

📅 Third-Party Integrations: Sync study schedules with Google Calendar, Notion, and more, so AI-planned study sessions fit into your real-life schedule.

Let Final Ninja turn your stress into strategy and anxiety into action. With AI-powered planning and fun, gamified studying, you’ll tackle finals like a true ninja! 🥷🔥

contributor

  1. Mustang Wu: team leader, Godot development
  2. Joan Gao:adhd mode function development
  3. Panda Zhang: moodle courses analysis developer
  4. Zoey Cao: moodle courses analytics developer

About

Final Ninja: Your Smart AI Study Companion for Finals

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •