Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/manuthecoder/elmasri-client
AI AP Physics tutor trained with the Official CollegeBoard resources
https://github.com/manuthecoder/elmasri-client
ai ap collegeboard physics
Last synced: 12 days ago
JSON representation
AI AP Physics tutor trained with the Official CollegeBoard resources
- Host: GitHub
- URL: https://github.com/manuthecoder/elmasri-client
- Owner: manuthecoder
- Created: 2024-11-06T02:15:20.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-01-09T20:28:23.000Z (about 1 month ago)
- Last Synced: 2025-01-09T21:31:54.059Z (about 1 month ago)
- Topics: ai, ap, collegeboard, physics
- Language: TypeScript
- Homepage: https://elmasri.my.to
- Size: 4.42 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# **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
## The technical stuff
- Built with [React](https://react.dev) & [Next.JS](nextjs.org), and deployed with [Cloudflare Pages](https://pages.dev) and [Vercel](https://vercel.com)
- Domain name from [freedns.afraid.org](https://freedns.afraid.org)
- AI Model based on [Gemini 1.5-Flash](https://ai.google.dev/)
- Frontend UI built with [TailwindCSS](https://tailwindcss.com/) and [ShadCN UI](https://ui.shadcn.com/)
- Frontend database built using `localStorage`
- Text editing built with [TipTap Pro](https://tiptap.dev/) and [MathQuill](http://mathquill.com/) math equation rendering
- Project management done with [Dysperse](https://dysperse.com)
This project was part of Hack Club's [High Seas](highseas.hackclub.com) program.
---
### Love this project? Check out [Dysperse](https://click.dysperse.com/qU2SIVR)!
Want to 🔒 lock in and see your grades improve!? 📈📈
There's a great productivity platform out there called [Dysperse](https://dysperse.com) 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!