Skip to content

AI AP Physics tutor trained with the Official CollegeBoard resources

Notifications You must be signed in to change notification settings

manuthecoder/elmasri-client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

https://elmasri.my.to/og.png

ElmasriAI

AP Physics tutor, trained with the Official CollegeBoard resources

ElmasriAI is a smart assistant designed to help students of Irvine High’s AP Physics class, taught by Mr. Joseph Elmasri, navigate complex concepts in physics with ease and insight. Built by Manu G, ElmasriAI blends the knowledge and personality of Mr. Elmasri to create an engaging and interactive learning tool.

ElmasriAI is modeled after the real Mr. Elmasri, known for his chill and approachable demeanor. Students are familiar with his tradition of offering 🍬 candy, especially after tests, and his love for 🥤 soda and 🎸 rock music—sometimes catching him with a party-size soda during exams. For those stressed by physics, he offers candy and even access to his ☕ coffee machine, creating a supportive classroom vibe. With experience as a UC Irvine alumnus, Mr. Elmasri advocates for academic integrity and infuses his passion for physics into every lesson.

ElmasriAI offers:

  • 🎙️ Voice Recognition: Too lazy to type? Just hit the microphone button and start speaking!
  • 😎 Friendly, yet Structured Guidance: Students appreciate the AI's relaxed tone, though it's still focused on school-appropriate, educational content.
  • 🎢 Physics Expertise: From kinematics to rotational dynamics, ElmasriAI explains topics in concise and readable ways, using real-world examples that make physics relatable.
  • 🔁 Built-In Redirection: While students enjoy exploring Mr. Elmasri’s personality, ElmasriAI keeps discussions physics-centered. Any attempts to shift the topic to unrelated or inappropriate areas are politely redirected back to class-relevant content.
  • Formula Support: ElmasriAI incorporates LaTeX for clear, precise formula representation, so students get used to seeing equations the way they appear on exams, like $F = ma$.
  • 🤫 Spoilers: Instead of just giving away an answer to a whole physics problem, ElmasriAI will divide the steps into clickable sections so students can reveal steps one-by-one.
  • 🧠 Focus on Scientific Practices: ElmasriAI encourages critical thinking by leading students through problem-solving techniques rather than simply providing answers. Key areas include mathematical routines, creating representations, and experimental design.
  • 📲 PWA: Add ElmasriAI to your home screen by clicking "Install app!"
  • 🕰️ Chat History: Access previous conversations with ease
  • Rate Limiting and Bot Prevention: Prevents malicious visitors and potential abuse cases

ElmasriAI is more than just an assistant; it’s a digital re-creation of Mr. Elmasri’s teaching style, encouraging students to learn independently while also providing the guidance needed for AP Physics success.

Screenshots

image image image image

The technical stuff

This project was part of Hack Club's High Seas program.


Love this project? Check out Dysperse!

Want to 🔒 lock in and see your grades improve!? 📈📈 There's a great productivity platform out there called Dysperse that can help you stay on top of your game.

  • It's approved by IUSD ✅
  • Automatically syncs assignments from Canvas 🔁
  • As seen on the Irvine High's newspaper, El Vaquero! 📰🤠
  • Over 12,000 students rely on this app!