HandCheckAI là một ứng dụng giao diện đồ họa (GUI) giúp bạn đo các góc trên bàn tay từ ảnh đầu vào bằng cách sử dụng MediaPipe, OpenCV, và Tkinter. Phù hợp để phân tích động tác tay trong vật lý trị liệu, giáo dục, hoặc nghiên cứu khoa học.

• Tải ảnh tay từ thư mục
• Tự động phát hiện và vẽ landmark bàn tay
• Tính toán các góc quan trọng trên ngón tay
• Duyệt từng ảnh hoặc xử lý hàng loạt
• Lưu kết quả vào file Excel (.xlsx)

HandCheckAI/
├── main.py
└── hand_angle_measurement/
    ├── __init__.py
    ├── app.py
    ├── processor.py
    ├── utils.py
    ├── widgets/
    │   ├── __init__.py
    │   ├── image_canvas.py
    │   └── info_panel.py
    └── models/
        ├── __init__.py
        └── measurement.py

git clone https://github.com/bbqqvv/HandCheckAI.git
cd HandCheckAI

python -m venv .venv

• Windows:

  .venv\Scripts\activate

• macOS/Linux:

  source .venv/bin/activate

pip install -r requirements.txt

Hoặc nếu không có file requirements.txt, hãy cài thủ công:

pip install mediapipe opencv-python numpy Pillow openpyxl

python main.py

• File Excel (.xlsx): chứa thông tin tên ảnh và các góc đo được
• Giao diện: hiển thị ảnh gốc và kết quả vẽ landmark + góc

• Ứng dụng sử dụng MediaPipe Hands của Google để nhận diện tay
• Hỗ trợ 1–2 bàn tay trong mỗi ảnh
• Khuyến khích ảnh đầu vào là hình vuông hoặc được resize để tránh cảnh báo từ MediaPipe

Dự án phát hành theo giấy phép MIT.

Bạn có thể đóng góp bằng cách:

• Mở issue nếu phát hiện lỗi
• Gửi pull request để cải thiện tính năng
• Đề xuất tính năng mới

bbqqvv