Skip to content

LexAyudha/Lexayudha-static

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

23 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Empowering Neurodiverse Adolescents through Adaptive Learning

LexAyudha Banner

๐Ÿง  Project Overview

LexAyudha is an innovative, AI-powered learning platform designed to assist adolescents with dyslexia and dyscalculia. By combining advanced AI, NLP, emotion detection, and multisensory teaching strategies, LexAyudha provides a truly personalized and inclusive educational experience. The system adapts content dynamically based on each learnerโ€™s cognitive and emotional state to improve comprehension, engagement, and confidence.

๐ŸŽฏ Core Components

  1. ๐ŸŽจ Chromatic Teaching Module โ€“ Reduces visual stress through real-time contrast and font adjustments.
  2. ๐Ÿงพ Adaptive Content Generator โ€“ Simplifies sentences using a fine-tuned BERT model for individualized reading levels.
  3. ๐Ÿ˜ Emotion Detection AI โ€“ Real-time facial analysis with Xception and MTCNN to tailor task difficulty based on emotion.
  4. ๐Ÿ”Š Speech Pace Optimizer โ€“ CNN-RNN model predicts ideal speech rate and delivers audio via Google TTS.
  5. ๐Ÿงฎ Touch Math Platform โ€“ Gamified, multisensory math learning with voice feedback and interaction tracking.

โœจ Key Features

  • AI-Powered Personalization โ€“ Emotion-aware, content-adaptive learning environment
  • Speech & Audio Feedback โ€“ Real-time pronunciation and pace correction
  • Gamified Math Support โ€“ Touch-point interaction and real-time quizzes
  • Inclusive Design โ€“ WCAG-compliant UI with chromatic variation and font customization
  • Progress Analytics โ€“ Emotional reports and academic insights for guardians and educators

๐Ÿ› ๏ธ Technology Stack

๐Ÿง  AI & Machine Learning

  • Python โ€“ Core language for AI modules
  • TensorFlow & Keras โ€“ Model training for emotion and speech prediction
  • BERT (fine-tuned) โ€“ Sentence simplification and level adaptation
  • Xception Model + MTCNN โ€“ Real-time emotion classification
  • Hybrid CNN-RNN โ€“ Speech pace prediction from mel spectrograms
  • Wav2Vec 2.0 โ€“ Audio temporal pattern recognition

๐Ÿงฉ Frontend Development

  • React.js โ€“ Component-based UI
  • Tailwind CSS โ€“ Utility-first responsive styling
  • SVG + Canvas โ€“ Touch point math visualizations
  • React-voice-visualizer โ€“ Speech calibration feedback

๐Ÿงช Backend & Architecture

  • Node.js & Express.js โ€“ API-driven services
  • Python Flask โ€“ ML microservices
  • MongoDB Atlas โ€“ NoSQL cloud database
  • RabbitMQ โ€“ Messaging queue for microservice communication
  • Docker & Kubernetes โ€“ Containerization and orchestration

๐Ÿ”‰ Data & Audio Processing

  • Librosa โ€“ Audio processing and mel spectrogram generation
  • NLTK & SpaCy โ€“ NLP for sentence restructuring
  • Chroma.js โ€“ Real-time visual theme rendering

โ˜๏ธ Cloud & DevOps

  • AWS Fargate โ€“ Serverless backend container hosting
  • Vercel โ€“ Frontend deployment platform
  • Firebase โ€“ Image storage and real-time data
  • SendGrid โ€“ Transactional and notification emails
  • Google TTS API โ€“ Custom speech playback
  • GitHub Actions โ€“ CI/CD pipeline
  • Git โ€“ Version control

๐Ÿ“Š Testing & Monitoring

  • Jest โ€“ Unit testing
  • Postman & Selenium โ€“ API and integration testing
  • Apache JMeter โ€“ Performance and load testing
  • Prometheus & Grafana โ€“ Monitoring and visualization

Developed as part of a BSc (Hons) Software Engineering final year project at the Sri Lanka Institute of Information Technology โ€“ 2025. EOF

๐Ÿš€ Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/IsuruX98/Intelligent-Eco-Urban-Monitoring-System.git
    cd Intelligent-Eco-Urban-Monitoring-System
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Set up environment variables

    cp .env.example .env.local

    Configure the following variables in .env.local:

    NEXT_PUBLIC_EMAILJS_SERVICE_ID=your_emailjs_service_id
    NEXT_PUBLIC_EMAILJS_TEMPLATE_ID=your_emailjs_template_id
    NEXT_PUBLIC_EMAILJS_PUBLIC_KEY=your_emailjs_public_key
  4. Add required assets

    • Place team member images in public/images/
    • Add document PDFs in public/documents/
    • Add presentation PDFs in public/presentations/
  5. Run the development server

    npm run dev
    # or
    yarn dev
  6. Open your browser Navigate to http://localhost:3000

๐Ÿ“ Project Structure

IEMS-Static/
โ”œโ”€โ”€ components/           # React components
โ”‚   โ”œโ”€โ”€ About.tsx        # Team information
โ”‚   โ”œโ”€โ”€ Contact.tsx      # Contact form and information
โ”‚   โ”œโ”€โ”€ Downloads.tsx    # Documents and presentations
โ”‚   โ”œโ”€โ”€ Hero.tsx         # Landing section
โ”‚   โ”œโ”€โ”€ Methodology.tsx  # Project methodology
โ”‚   โ”œโ”€โ”€ Milestones.tsx   # Project timeline
โ”‚   โ”œโ”€โ”€ Navbar.tsx       # Navigation component
โ”‚   โ”œโ”€โ”€ ProjectScope.tsx # Literature survey and objectives
โ”‚   โ””โ”€โ”€ Technologies.tsx # Technology stack
โ”œโ”€โ”€ pages/               # Next.js pages
โ”‚   โ”œโ”€โ”€ _app.tsx        # App configuration
โ”‚   โ”œโ”€โ”€ _document.tsx   # Document structure
โ”‚   โ””โ”€โ”€ index.tsx       # Main page
โ”œโ”€โ”€ public/              # Static assets
โ”‚   โ”œโ”€โ”€ documents/      # PDF documents
โ”‚   โ”œโ”€โ”€ images/         # Images and photos
โ”‚   โ””โ”€โ”€ presentations/  # Presentation files
โ”œโ”€โ”€ styles/             # CSS styles
โ””โ”€โ”€ README.md           # Project documentation

๐Ÿ“Š Project Milestones

  • โœ… Project Proposal - August 23, 2024
  • โœ… Progress Presentation I - December 8, 2024
  • ๐Ÿ”„ Research Paper - February 2025
  • โณ Progress Presentation II - March 2025
  • โณ Website Assessment - April 2025
  • โณ Logbook - April 2025
  • โณ Final Report - May 2025
  • โณ Final Presentation & Viva - May 26, 2025

๐Ÿ”ง Development

Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run start - Start production server
  • npm run lint - Run ESLint
  • npm run lint:fix - Fix ESLint errors

Code Quality

The project follows strict linting rules and TypeScript standards:

  • ESLint configuration for React and TypeScript
  • Proper entity escaping for accessibility
  • Unused import detection and removal
  • Consistent code formatting

๐Ÿ“„ Documentation

Available Downloads

  • Topic Assessment - Research area and scope definition
  • Project Proposal - Individual proposals (Google Drive)
  • Research Paper - Academic publication (Coming Soon)
  • Final Report - Individual project reports (Google Drive)

Presentations

  • Project Proposal - Initial concept presentation
  • Progress Presentation I - Development progress showcase
  • Progress Presentation II - Advanced functionality demo (Coming Soon)
  • Final Presentation - Complete implementation overview (Coming Soon)

๐Ÿค Contributing

We welcome collaboration opportunities, research partnerships, and inquiries about IEMS. Whether you're a researcher, environmental agency, or technology partner, we'd love to hear from you.

Contact Information

  • Email: [email protected]
  • Phone: +94 76 685 9740
  • Institution: Sri Lanka Institute of Information Technology, Malabe, Sri Lanka

Project Links

๐Ÿ“œ License

This project is developed as part of academic research at Sri Lanka Institute of Information Technology (SLIIT). All documents and presentations are provided for educational and research purposes.

๐Ÿ™ Acknowledgments

  • Sri Lanka Institute of Information Technology (SLIIT)
  • Department of Information Technology
  • Department of Computer Science and Software Engineering
  • Research supervisors and academic staff
  • Environmental monitoring research community

LexAyudha - AI-Based Personalized Rehabilitation Tool for Dyslexic Adolescents
Every_child_is_special

For more information, visit our project website or contact our team.

Lexayudha-static

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages