signspell logo

signspell

認領

signspell 是一款 Python 套件,可透過 webcam 即時辨識美國手語字母拼寫,支援命令列與可匯入的 library API,內建模型與 webcam UI。

signspell preview

概覽

signspell 是一款 Python 套件,可透過 webcam 即時辨識美國手語字母拼寫。它專注於手動字母,能即時辨識 A–Z,並透過精緻的螢幕介面呈現結果。

此專案結合 MediaPipe 手部追蹤與以 30 幀關鍵點序列訓練的 LSTM 模型。它內附預訓練模型,可透過命令列或作為可匯入的 library 使用,適合想要即時 webcam 辨識而非離線影像分類的使用者。

功能

ASL 字母拼寫辨識

可即時從 webcam 輸入辨識美國手語字母拼寫,涵蓋 A 到 Z。

序列式辨識流程

根據專案說明,使用 MediaPipe 手部追蹤與以 30 幀關鍵點序列訓練的 LSTM 模型。

內建模型與 UI

內含預訓練模型與精緻的 webcam UI,因此無需先自行接好模型即可執行。

CLI 控制

可作為命令列工具使用,並提供相機選擇、信心閾值、鏡像顯示控制與自訂模型路徑等選項。

Library API

可作為 library 匯入,提供用於完整 UI 的 `signspell.run()`,以及用於程式化逐幀預測的 `Recognizer`。

緩衝輸出處理

使用 30 幀的循環緩衝區與短暫穩定視窗,協助在字母確認前減少抖動。

使用情境

  • 即時 webcam 辨識

    從終端執行 signspell,以預設相機或指定的 webcam 索引辨識手寫字母,並視需要調整信心閾值或鏡像模式。

  • 嵌入式 UI 使用

    在 Python 應用程式中匯入此套件,並呼叫 `signspell.run()`,將完整的 webcam UI 整合到自己的工作流程中。

  • 程式化逐幀推論

    當你想自行處理影格並在程式中管理預測字母時,可搭配 OpenCV 影格擷取使用 `Recognizer` 類別。

  • 自訂模型整合

    當你已經有相容且符合預期輸入與輸出形狀的模型時,可用自訂 `.h5` 檔取代內建模型。

  • 互動式 ASL 示範

    可將此套件用於易於理解的展示、課堂範例,或以即時 ASL 手動字母辨識為主要互動方式的原型。

Pros and Cons

Pros

  • 可從 webcam 輸入即時辨識 ASL 手動字母。
  • 同時提供 CLI 與 library 使用方式,適用不同工作流程。
  • 隨附預訓練模型與開箱即用的 UI。
  • 支援自訂模型路徑,方便使用者替換自己的模型。
  • 文件說明了具體執行行為,例如相機選擇、閾值設定、鏡像與鍵盤控制。

Cons

  • 即時辨識需要 webcam。
  • 來源僅將支援的 Python 版本限制為 3.9–3.11。
  • 專案說明除了安裝與基本 CLI/library 範例外,未提供更多設定細節。

FAQ

我該如何使用 signspell?

它提供命令列介面與可匯入的 Python library。CLI 可使用預設 webcam 或指定相機,而 library 則提供 `signspell.run()` 與 `Recognizer` 類別,方便逐幀預測。

執行時有哪些需求?

專案說明指出,它需要 Python 3.9–3.11,以及一個 webcam 來進行即時辨識。

它可以辨識什麼?

來源指出,它可即時辨識美國手語字母拼寫(A–Z),並包含穩定性視窗以減少字母確認前的閃爍。

signspell 使用什麼授權?

PyPI 顯示此專案採用 MIT License (MIT)。

我可以使用自己的模型嗎?

你可以使用 `--model path/to/your_model.h5` 或 `Recognizer(model_path=...)` 指向自訂模型。來源說明模型必須接受 `(1, 30, 63)` 的輸入形狀,並輸出 26 個類別分數。

Quick Facts

類別
Developer Tool
套件名稱
signspell
平台
Python 3.9–3.11
主要輸入
Webcam video
授權
MIT License (MIT)
來源網域
pypi.org