Skip to content

hannahchgit/explain-it-5-ways

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧮 Explain It 5 Ways

Any math problem, explained five different ways — tailored for how you learn.

Streamlit App Python 3.9+ Powered by Claude License: MIT


What It Does

Paste in any math problem — an equation, a word problem, a calculus expression — and get five distinct explanations generated by Claude:

Tab What you get
📝 Step-by-Step Every step shown clearly, with all working
👁️ Visual Diagrams, ASCII art, spatial layouts
🧸 ELI5 Explained like you're 5, with fun real-world analogies
Shortcut The fast trick for exams — pattern recognition and speed
🎯 Mistakes The 3–4 most common errors students make, and how to avoid them

Built for Every Learner

One size doesn't fit all. Enable your learning profile in the sidebar and every explanation adapts:

Profile How explanations change
ADHD / Attention-focused Bullet points, bold key terms, short sentences, TL;DR summaries
Dyslexia-friendly Simple vocabulary, small chunks, lots of whitespace
Visual learner Diagrams and spatial descriptions first
Kinesthetic learner Real-world objects and physical actions
Auditory learner Conversational tone, verbal cues, mnemonics
Autism-friendly / Literal No idioms, fully explicit steps, zero ambiguity

Mix and match profiles — they all work together.

Accessibility Controls

  • Font size — scale from 14px to 26px
  • High contrast mode — black background, yellow text
  • Dyslexia-friendly font — switches to OpenDyslexic

Running Locally

# 1. Clone
git clone https://github.com/hannahchgit/explain-it-5-ways.git
cd explain-it-5-ways

# 2. Install dependencies
pip install -r requirements.txt

# 3. Add your API key
cp .streamlit/secrets.toml.example .streamlit/secrets.toml
# Edit secrets.toml and paste your Anthropic API key

# 4. Run
streamlit run app.py

Get a free API key at console.anthropic.com.


Deploy to Streamlit Cloud

  1. Fork this repo to your GitHub account
  2. Go to share.streamlit.io and connect your repo
  3. In the app settings, open Secrets and add:
    ANTHROPIC_API_KEY = "sk-ant-..."
  4. Hit Deploy — that's it

Tech Stack


License

MIT — use it, fork it, build on it.

About

Any math problem explained 5 ways — tailored for ADHD, dyslexia, visual learners, and more.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages