README.md

metadata

title: CoreQuest - Master Physics and Math with AI
emoji: 🎯
colorFrom: indigo
colorTo: purple
sdk: streamlit
app_file: app.py
pinned: true

🎯 CoreQuest: Master Physics and Math!

CoreQuest is an open-source AI-powered learning platform designed for high school and college students to master physics and mathematics through engaging, gamified learning experiences.

---

🚀 Features

• 🤖 AI-generated content: Get instant explanations and practice questions from Hugging Face’s Mistral-7B model.
• 💬 Smart chatbot: Ask topic-specific questions and receive instant answers.
• 🏆 XP Progress System: Level up as you interact (like Duolingo).
• 🔭 Interactive Simulations: View physics simulations from PhET.
• 🎁 Hint and Retry System: Get hints and generate new practice sets to master topics.

---

📚 Topics Covered

Physics:

• Classical Mechanics
• Thermodynamics
• Electricity & Magnetism
• Optics
• Special Relativity

Mathematics:

• Algebra
• Geometry
• Trigonometry
• Calculus I
• Calculus II
• Multivariable Calculus

---

🧩 How It Works

1. Enter a topic (e.g., "Newton’s Laws", "Derivatives").
2. The AI generates:
   • A simple, short explanation.
   • Three relevant practice questions.
3. Use the app to:
   • Ask follow-up questions through the chatbot.
   • View simulations connected to your topic.
   • Earn XP points for each interaction and level up!

---

🔐 Security Notice

This app uses a Hugging Face Inference API token stored securely as a Repository Secret (HF_TOKEN).
No sensitive information is exposed in the code.

---

✨ Built With

• Streamlit – UI Framework
• Hugging Face Transformers – AI backend
• PhET Simulations – Physics simulation demos
• Python Requests – API handling

---

💡 Vision

CoreQuest was created for the Tech Titans Hackathon to empower students through intelligent, interactive learning, making STEM education accessible and fun.

We believe in:

• Making physics and math exciting and not intimidating.
• Combining games, simulations, and AI to personalize learning.
• Supporting students globally in mastering fundamental scientific concepts.

---

Made with ❤️ by Benjamin Kaindu Mushinge