Skip to content
Notifications You must be signed in to change notification settings

shania-codes/mathmagician

Folders and files

NameName
Last commit message
Last commit date

Latest commit

author
Shania
Oct 12, 2025
6f1d689 · · Oct 12, 2025

History

18 Commits
Oct 12, 2025
Oct 12, 2025
Oct 12, 2025
Oct 12, 2025
Oct 12, 2025

Repository files navigation

Mathmagician

Makes practice questions for you and tests you on them. Maths is magic ∴ anyone can be a magician..

Demo

Screenshot Interactive Demo

Features

  • Matrix Multiplication questions and answers
  • Easy Quadratic Equation Differentiation questions and answers
  • Save stats (attempts, successes) and reset stats buttons
  • Separate stats for each exercise
  • Spellbook design, with index page for different maths
  • User gains Mana for completing questions and can Rank up to different levels
  • Flash notifications when completing questions or when ranking up which also shows current mana progress
  • Different "player models" for different ranks (apprentice.png, etc)

Possible Updates:

  • Daily streak bonus xp, logarithmic increase
  • Rank up animations
  • Gamified Experience with story telling and RPG elements
  • Show XP bar increasing animation when completing questions
  • Graph tracking progres over time
  • KaTeX rendering https://katex.org/
  • Hint levels up to the fully explained working out with the numbers used in the question
  • Speed arithmetic questions for rapid incantation-less casting
  • Flash mental arithmetic questions
  • Scratch pad area for notes and drawing
  • On screen calculator

Self hosting instructions (intended use)

git clone https://github.com/shania-codes/mathmagician  
cd mathmagician  
python3 -m venv venv  
source venv/bin/activate  
pip install flask  
flask run  
https://127.0.0.1:5000  
000  

Tested working on Ubuntu Server 25.04: Interactive Demo

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published