Skip to content

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

MorseAI — Smart Morse Code Decoder powered by Computer Vision & AI

🏆 Winner — Piscine POC Hackathon

A real-time Morse code interpreter powered by Computer Vision and AI. Uses MediaPipe hand-tracking and OpenCV to decode Morse signals from finger gestures, with intelligent LLM-based text correction for seamless human-to-machine communication.

Python MediaPipe OpenCV LLM


Overview

MorseAI lets you type Morse code using finger gestures in front of a webcam. The system detects hand movements in real time through computer vision, decodes the Morse into text, and automatically corrects errors using a Large Language Model.

How it works

Right hand — Morse input:

  • Thumb + Index → Dot ·
  • Thumb + Middle → Dash

Left hand — Control:

  • Thumb + Index → Validate letter
  • Thumb + Middle → New word + AI correction

Architecture

┌──────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Finger     │ ──▶ │  MediaPipe   │ ──▶ │    Morse     │ ──▶ │     LLM      │
│   Gestures   │     │  + OpenCV    │     │   Decoding   │     │  Correction  │
└──────────────┘     └──────────────┘     └──────────────┘     └──────────────┘
     Input            Computer Vision       · − → Letter        Corrected text

Installation

Prerequisites

  • Python 3.10+
  • Working webcam

Setup

# Clone the repo
git clone git@github.com:A-Kamil/MorseAi.git
cd morseai

# Install dependencies
pip install -r requirements.txt

Main dependencies

mediapipe
opencv-python
flask
requests

Usage

python web_app.py

Open your browser at the address shown in the terminal.

  1. Place both hands in front of the camera
  2. Right hand: touch thumb + index for a dot, thumb + middle for a dash
  3. Left hand: touch thumb + index to validate a letter, thumb + middle to separate words and trigger AI correction
  4. Raw text and AI-corrected text are displayed in real time

Tech Stack

Technology Role
MediaPipe Hands Real-time detection of 21 hand landmarks per hand
OpenCV Video capture, image processing, landmark display
LLM API Intelligent contextual correction of decoded text

Features

  • ✅ Real-time dual hand gesture detection
  • ✅ Morse input by finger choice (index = dot, middle = dash)
  • ✅ Live Morse → text decoding
  • ✅ Automatic LLM-powered text correction
  • ✅ Web interface with buffer, raw phrase, and corrected text display
  • ✅ Built-in Morse code reference grid

About

A real-time Morse code interpreter powered by Computer Vision and AI. Uses MediaPipe hand-tracking and OpenCV to decode Morse signals from finger gestures, with intelligent LLM-based text correction for seamless human-to-machine communication.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages