---
---
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](https://streamlit.io) – UI Framework
- [Hugging Face Transformers](https://huggingface.co) – AI backend
- [PhET Simulations](https://phet.colorado.edu) – Physics simulation demos
- [Python Requests](https://docs.python-requests.org) – 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