README.md

---
title: CalcTrainer
emoji: 🧮
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.34.2
app_file: app.py
pinned: false
license: mit
short_description: Mental math training with handwriting OCR recognition
---

# CalcTrainer 🧮

**Mental math training with handwriting OCR recognition**

Practice your mental calculation skills by writing answers by hand! CalcTrainer uses advanced OCR to recognize your handwritten numbers and provides instant feedback.

## Features

- ⏱️ **Timed sessions**: 30 or 60-second math challenges
- 🔢 **Multiple operations**: Addition, subtraction, multiplication, division, or random mix
- 📈 **Difficulty levels**: Easy and Hard modes for each operation
- ✍️ **Handwriting recognition**: Write your answers naturally with pen/finger
- 📊 **Detailed results**: See exactly which problems you got right or wrong
- 🎯 **Real-time feedback**: Instant OCR recognition of your handwritten answers

## How to use

1. **Configure** your session (duration, operation type, difficulty)
2. **Start** the game and solve math problems
3. **Write** your answers in the drawing area
4. **Submit** each answer to move to the next problem
5. **Review** your results at the end

## Technology

- **OCR Engine**: Microsoft TrOCR for accurate handwriting recognition
- **Framework**: Gradio for interactive web interface
- **Deployment**: Optimized for HuggingFace Spaces with ZeroGPU

Perfect for students, teachers, and anyone looking to improve their mental math skills!