Hermes AI-powered learning system

🧠 Hermes Classroom Engine — A Structured AI Math Tutor Built on Agentic Learning Ideas

I built a lightweight AI-powered learning system inspired by the Hermes agent concept, focused on one goal:

Helping young students understand fractions through step-by-step visual learning instead of memorization.

🎯 What I Built

The system is a Flask-based educational engine with two main parts:

📊 1. Learning Engine (Solver Mode)

It takes a fraction like:

3/4
5/16
2/3

and breaks it into:

step-by-step long division
digit-by-digit construction of the decimal
final percentage conversion

Example output:

Decimal: 0.75
Percentage: 75%
Step-by-step digit harvesting process
❓ 2. Quiz Mode (Assessment Engine)

Students can:

input answers in percentage form
get instant feedback (correct / incorrect)
track score and streak
build learning progress over time
📊 3. Student Dashboard

The system also tracks:

student score
attempt history
performance over time
leaderboard ranking
🧠 Core Idea (The “Learning Loop”)

Instead of just answering questions, the system creates a loop:

Student inputs problem
System explains step-by-step solution
Student is tested via quiz
Performance is stored
Progress builds over time

This mimics a simplified agentic learning cycle:

act → explain → test → improve

⚙️ Tech Stack
Python (Flask backend)
HTML/CSS/JavaScript frontend
JSON-based lightweight database
REST API communication
🎮 What Makes It Different

Most AI tutors:

give direct answers

This system:

breaks reasoning into visible steps
builds the answer digit by digit
forces understanding through structure
tracks learning over time
🧩 Design Philosophy

The goal was not to build a chatbot.

It was to build:

a structured thinking engine for early learners

focused on:

clarity
repetition
visual learning
low cognitive overload
🚀 Future Direction

If expanded, this system could evolve into:

full classroom analytics system
adaptive difficulty engine
AI-generated personalized exercises
multi-student classroom simulation
🧠 Final Note

This project started as a simple fraction solver but evolved into a structured learning system inspired by agent-like workflows:

not just answering — but teaching through steps, feedback, and repetition.

🔗 End here is the live link https://github.com/AhmedAnterElsayed/hermes-classroom