Skip to content

AI-powered riddle generator designed to challenge your brain with fun, creative, and tricky math riddles!

License

Notifications You must be signed in to change notification settings

hassanhaseen/MathRiddleFactory

Repository files navigation

🧮 Math Riddle Factory - AI-Powered Math Riddle Generator

Math Riddle Factory Logo

Welcome to Math Riddle Factory — an AI-powered riddle generator designed to challenge your brain with fun, creative, and tricky math riddles! Whether you’re a puzzle enthusiast or just looking for a fun way to test your math skills, Math Riddle Factory makes it easy and enjoyable.


✨ Features

✅ Instantly generate creative math riddles with AI
✅ Click-to-reveal answers for interactive learning
✅ Customizable riddle generation (number of riddles, creativity level)
✅ Smooth and responsive UI with loading indicators
✅ Sidebar controls for a clean and intuitive interface
✅ Fully responsive and dark-themed design
✅ Powered by a fine-tuned GPT-2 model hosted on Hugging Face
✅ Streamlit app with seamless deployment on Streamlit Cloud


📸 Preview

Riddle Generation Controls
Home Controls

✍️ Medium Blog

🔗 Read our Medium Blog


🚀 Live Demo

🔗 Try Math Riddle Factory Live on Streamlit!


🧠 How It Works

Math Riddle Factory uses a fine-tuned GPT-2 Transformer model trained on a custom dataset of math riddles and their solutions.

📚 Dataset
Math_Riddle_Factory_Dataset.csv
30 hand-crafted math riddles with solutions for fine-tuning GPT-2.

🧮 Model
A fine-tuned GPT-2 (MathRiddleGPT2) hosted on Hugging Face. The model generates creative and logical math riddles in response to prompts.


🖼️ App Highlights

  • Loader/Spinner while generating riddles to keep users informed
  • Click-to-Reveal answers for an interactive quiz experience
  • Sidebar Controls for number of riddles and creativity tuning
  • Team CodeRunners Footer with hover effect revealing team members' names
  • Clean and minimal UI optimized for a fun user experience

🤝 Team CodeRunners

Developed with ❤️ by:

Hover over Team CodeRunners in the app footer to see our names! 🎉


📝 License

This project is licensed under the MIT License.


⭐️ Give us a Star!

If you like Math Riddle Factory, please ⭐ the repo!
It motivates us to build more fun AI projects! 😊


⚙️ Tech Stack

  • Streamlit for the interactive web app
  • Hugging Face Transformers for fine-tuned GPT-2
  • Torch for model inference
  • Hugging Face Hub for model hosting

About

AI-powered riddle generator designed to challenge your brain with fun, creative, and tricky math riddles!

Topics

Resources

License

Stars

Watchers

Forks

Languages