README.md

---
title: Language Learning App - Grammar Checker
emoji: 🎓
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.15.0
app_file: app.py
pinned: false
license: mit
---

# Language Learning Application - Grammar Checker

An AI-powered language learning application that provides:

## Features

- **📝 Writing Analysis**: Submit your writing for automated grammar checking and error correction
- **🏋️ Exercise Creation**: Generate grammar exercises from text containing errors
- **✏️ Exercise Practice**: Practice with generated exercises and get scored feedback
- **📊 Progress Tracking**: Track student progress across submissions and exercises

## How to Use

### For Students:
1. **Writing Analysis**: Enter your name and paste your writing in the "Writing Analysis" tab
2. **Exercise Practice**: Use exercise IDs to practice grammar exercises
3. **View Progress**: Check your improvement over time

### For Teachers:
1. **Create Exercises**: Use the "Exercise Creation" tab to generate exercises from error-containing text
2. **Monitor Progress**: Track student submissions and exercise performance
3. **Assign Practice**: Share exercise IDs with students for targeted practice

## Technology

- **Neural Networks**: Uses advanced T5 and ELECTRA models for grammar error detection and correction
- **Models**: 
  - `Zlovoblachko/Realec-2step-ft-realec` for grammar correction
  - `Zlovoblachko/4tag-electra-grammar-error-detection` for error detection
- **Database**: SQLite for storing submissions, exercises, and progress
- **Interface**: Gradio for easy-to-use web interface

## Example Usage

1. **Submit Writing**: "I have went to the store yesterday" → "I went to the store yesterday"
2. **Create Exercise**: Input text with errors → Get numbered sentences for practice
3. **Practice**: Correct the sentences → Get immediate feedback and scoring

## Educational Value

This application helps language learners by:
- Providing immediate feedback on grammar errors
- Creating personalized practice exercises
- Tracking learning progress over time
- Offering detailed error analysis and corrections

Perfect for ESL students, writing practice, and grammar skill development!