README.md

metadata

title: Learnloop
emoji: 🔢💡
colorFrom: blue
colorTo: blue
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
short_description: AI tutor for math learners

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

LearnLoop - AI Tutor for math 🔢💡

LearnLoop is a lightweight AI-powered math tutor built with Gradio, SymPy, and Transformers. It explains mathematical questions at different skill levels and verifies expressions using symbolic computation.

Features

• Step-by-step explanations for math expressions
• Beginner, Intermediate, and Advanced levels
• Automatic math verification using SymPy
• Powered by Qwen2.5-1.5B-Instruct
• Clean, responsive UI with soft visual rhythm and microinteractions
• Keyboard support

Getting started

1. Clone the repository

git clone https://github.com/your-username/learnloop.git
cd learnloop

2. Install dependencies

pip install -r requirements.txt

3. Run the app

python app.py

4. Turn on the light mode on your browser

Requirements

See requirements.txt for full list

Explanation logic

• Uses Qwen2.5-1.5B-Instruct via HuggingFace Transformers
• Prompt includes:
  • System messge to guide tone
  • Dynamic style string based on level and step-by-step toggle
  • User question
• Response is trimmed to remove artifacts

UI Design

• Built with gr.Blocks()for modular layout
• Styled using embedded CSS via gr.HTML()
• .gradio-container to add color to the background
• Buttons styled with hover, focus and click effects
• Markdown used for instructions and output display

Output format

• Explanation from the model
• Divider line
• SymPyverification result
• Status note (e.g. Transformers CPU)