A simple-to-use web app providing real-time educational help to students.

Check out a demo of this app by clicking below!

Have you ever seen a new word and wondered what it meant? ReadAble was inspired by the struggle of students learning a new language, often needing constant translations to understand books. Our app provides real-time reading assistance to help bridge that gap.

• Uses a camera to follow along as you read a book.
• Provides real-time reading help, including:
  • Text-to-speech (TTS) that reads the book aloud.
  • Instant word definitions when a user points at an unknown word.
• Stores scanned books for future use or sharing with other users.

• Backend:
  Python (OpenCV, EasyOCR, pyttsx3, Pygame, MediaPipe, PyMultiDictionary) with Flask server.

• Frontend:
  HTML, CSS/SCSS, JavaScript handling camera feed and user interaction.

• Python 3.8+
• pip
• Virtual environment (optional but recommended)

1. Clone the repository:

   git clone https://github.com/harsharan-r/ReadAble.git
   cd ReadAble

2. Create and activate a virtual environment (optional):

   python -m venv venv
   
   ### For macOS/Linux ###
   source venv/bin/activate
   
   ### For Windows: ###
   venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Run the app:

   python app.py

5. Access in your browser at localhost:5001/

• Launch the app locally.
• Use your device’s camera to follow along while reading a book.
• Tap on a word to hear it pronounced or get a definition.

• Python
• Flask
• OpenCV
• EasyOCR
• pyttsx3
• Pygame
• MediaPipe
• PyMultiDictionary
• HTML, CSS/SCSS, JavaScript
• Visual Studio Code

• Devpost Project Page
• Demo Video