signspell icon

signspell

signspell is a Python package for live American Sign Language fingerspelling recognition from a webcam. It can be used from the command line or as a library, and it ships with a pretrained model and webcam UI.

signspell

Overview

signspell is a Python package for live American Sign Language fingerspelling recognition. It focuses on the manual alphabet, using webcam video to identify letters A through Z in real time.

The project ships with a pretrained model, a polished webcam UI, and both command-line and library entry points. It is designed for users who want to run live recognition immediately, or embed the recognizer in their own code and process frames one at a time.

Features

Live fingerspelling recognition

Recognizes the American Sign Language manual alphabet (A–Z) in real time from webcam input.

Sequence-based recognition pipeline

Uses MediaPipe hand tracking with an LSTM model trained on 30-frame keypoint sequences.

Bundled model and UI

Includes a pretrained model and a polished webcam interface for immediate use.

CLI and library usage

Can be run as a command-line tool or imported as a Python library.

Runtime controls

Supports adjustable camera selection, confidence thresholding, and mirrored-view toggling from the CLI.

Bring-your-own-model support

Accepts a custom model path, with documented expectations for input shape and output classes.

Use Cases

  • Live alphabet recognition

    Use signspell when you want to point a webcam at a signer’s hand and receive live A–Z letter predictions for fingerspelling practice or demo work.

  • Fast command-line experiments

    Run the CLI when you want a quick, no-code way to test the bundled model, switch cameras, or adjust the confidence threshold.

  • Python app integration

    Import the library in your own application when you need frame-by-frame recognition and want to integrate the recognizer into custom Python code.

  • Custom-model workflows

    Load a custom model when you already have a trained `.h5` model and want signspell’s webcam workflow with your own weights.

Pros and Cons

Pros

  • Recognizes the ASL manual alphabet in real time.
  • Ships with a pretrained model and a webcam UI.
  • Works from both the CLI and Python imports.
  • Provides simple runtime controls for camera selection, confidence, and mirroring.
  • Supports custom model loading for advanced users.

Cons

  • The project page only documents webcam-based live recognition, so it is not positioned for offline or non-visual workflows.
  • Custom models must match the documented input and output shape, which limits plug-in flexibility.

FAQ

How do I install signspell?

It is available as a Python package on PyPI and can be installed with `pip install signspell`. The project page also shows a versioned release, `1.0.1`.

What does signspell do?

The package runs live American Sign Language fingerspelling recognition from a webcam. It recognizes the manual alphabet (A–Z) in real time and can be launched from the command line or imported as a library.

What are the runtime requirements?

The project page says signspell requires Python 3.9–3.11 and a webcam for live recognition.

Can I use my own model with signspell?

Yes. The project includes a `--model path/to/your_model.h5` option and a `Recognizer(model_path=...)` constructor, so you can point it at your own model if it matches the expected input and output shape.

What controls are available in the webcam UI?

The source description lists in-window controls for the UI: `q` quits, `c` clears the sentence, and `SPACE` inserts a space.

Quick Facts

Category
Developer Tool
Package name
signspell
Version
1.0.1
License
MIT License
Python compatibility
Python 3.9–3.11
Primary interface
Webcam UI, CLI, and library