CoreQuest-AI / README.md
AIbyKaindu's picture
Update README.md
f562c6e verified
|
Raw
History Blame Contribute Delete
2.39 kB
---
---
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