CoolFace
Apppublic

Mayank14/Dyslexia-AI-Assistant

sourceHugging Faceupdated 1y agoView on Hugging Face
0likes
App README

Dyslexia AI Assistant

A web application that simplifies complex text using AI to help people with dyslexia and reading difficulties.

Features

  • —AI Text Simplification: Uses a T5 model to make complex text easier to read
  • —Dyslexia-Friendly Mode: Toggle for better readability with increased spacing
  • —Text-to-Speech: Built-in speech synthesis for both input and output
  • —Responsive Design: Works on desktop, tablet, and mobile
  • —Accessibility: High contrast, keyboard navigation, and screen reader support

Quick Start

Requirements

  • —Python 3.8 or higher
  • —pip

Installation

  1. 1.Install dependencies:
bash
   pip install -r requirements.txt
  1. 1.Run the app:
bash
   python app.py
  1. 1.Open your browser and go to:
   http://localhost:5000

How to Use

  1. 1.Enter text in the "Original Text" box
  2. 2.Click "Simplify Text" to process it
  3. 3.Read the simplified version in the output box
  4. 4.Use TTS buttons to hear the text read aloud
  5. 5.Toggle "Dyslexia-Friendly" for enhanced readability

API Endpoints

POST /simplify

Simplifies text using the T5 model.

Request:

json
{
  "text": "Your complex text here"
}

Response:

json
{
  "simplified_text": "Your simplified text here",
  "original_length": 25,
  "simplified_length": 20
}

Project Structure

Dyslexia AI Assistant/
├── app.py                    # Flask backend
├── requirements.txt          # Dependencies
├── templates/
│   └── index.html          # Main page
├── static/
│   ├── css/styles.css      # Styling
│   └── js/                 # JavaScript files
└── t5_simplifier_model/     # AI model files

Development

This application is built with:

  • —Flask (Backend)
  • —T5 Transformer Model
  • —HTML/CSS/JavaScript (Frontend)

The model is hosted on Hugging Face Hub at: Mayank14/t5-simplifier-model

Troubleshooting

Model not loading?

  • —Make sure the t5_simplifier_model folder is in the right place
  • —Check that you have enough RAM (model needs ~1GB)

Text-to-Speech not working?

  • —Use a modern browser
  • —Some browsers need user interaction before allowing TTS

App won't start?

  • —Check that Python 3.8+ is installed
  • —Make sure all dependencies are installed with pip install -r requirements.txt

Developed by Mayank Bansal

This project was created as an independent initiative to make reading more accessible for individuals with dyslexia and other reading challenges.