# varadha24/vision-based-bionic-hand architecture

> Architecture diagram of the GitHub repository varadha24/vision-based-bionic-hand, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/varadha24/vision-based-bionic-hand
- Repository: https://github.com/varadha24/vision-based-bionic-hand

## Overview

This is a webcam-driven robotic hand controller. The runtime captures and processes camera frames, detects hand landmarks, converts them into a five-bit finger pattern, and sends that pattern over serial to Arduino, which controls the finger servos. The Python source also displays annotated tracking output. Arduino and servo behavior are included as documented product stages; their implementation details were not sampled, so those links rely on the README.

Main entry points: [`ARM FINAL.py`](https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py) (Hand tracking), [`Arm_Final_Arduino/Arm_Final_Arduino.ino`](https://github.com/varadha24/vision-based-bionic-hand/blob/main/Arm_Final_Arduino/Arm_Final_Arduino.ino) (Arduino controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vision["Vision and tracking"]
  node_frame_capture["Frame capture<br/>[ARM FINAL.py]"]
  node_hand_tracking["Hand tracking<br/>[ARM FINAL.py]"]
  node_tracking_display["Tracking display<br/>[ARM FINAL.py]"]
end

subgraph group_gesture["Gesture conversion"]
  node_finger_detection["Finger detection<br/>[ARM FINAL.py]"]
  node_bit_pattern["Finger pattern<br/>[ARM FINAL.py]"]
end

subgraph group_hardware["Arm control"]
  node_serial_link["Serial link<br/>[ARM FINAL.py]"]
  node_arduino["Arduino controller"]
  node_servos["Finger servos"]
  node_robotic_hand["Bionic hand"]
end

node_user(("User hand"))
node_webcam["Webcam"]

node_user -->|"presents hand"| node_webcam
node_webcam -->|"provides frames"| node_frame_capture
node_frame_capture -->|"processes frames"| node_hand_tracking
node_hand_tracking -->|"supplies landmarks"| node_finger_detection
node_finger_detection -->|"encodes states"| node_bit_pattern
node_hand_tracking -->|"draws landmarks"| node_tracking_display
node_bit_pattern -->|"sends pattern"| node_serial_link
node_serial_link -->|"transmits serial"| node_arduino
node_arduino -->|"controls fingers"| node_servos
node_servos -.->|"moves fingers"| node_robotic_hand

click node_frame_capture "https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py"
click node_hand_tracking "https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py"
click node_tracking_display "https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py"
click node_finger_detection "https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py"
click node_bit_pattern "https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py"
click node_serial_link "https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py"
click node_arduino "https://github.com/varadha24/vision-based-bionic-hand/blob/main/Arm_Final_Arduino/Arm_Final_Arduino.ino"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frame_capture,node_hand_tracking,node_tracking_display,node_user toneBlue
class node_finger_detection,node_bit_pattern toneAmber
class node_serial_link,node_arduino,node_servos,node_robotic_hand toneMint
class node_webcam toneIndigo
```

## Components

### Vision and tracking

- [Frame capture](https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py): `ARM FINAL.py`
- [Hand tracking](https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py): `ARM FINAL.py`
- [Tracking display](https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py): `ARM FINAL.py`

### Gesture conversion

- [Finger detection](https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py): `ARM FINAL.py`
- [Finger pattern](https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py): `ARM FINAL.py`

### Arm control

- [Serial link](https://github.com/varadha24/vision-based-bionic-hand/blob/main/ARM%20FINAL.py): `ARM FINAL.py`
- [Arduino controller](https://github.com/varadha24/vision-based-bionic-hand/blob/main/Arm_Final_Arduino/Arm_Final_Arduino.ino): `Arm_Final_Arduino/Arm_Final_Arduino.ino`
- **Finger servos**
- **Bionic hand**

### Other components

- **User hand**
- **Webcam**

## Connections

- User hand → Webcam: presents hand (evidence: `README.md`)
- Webcam → Frame capture: provides frames (evidence: `ARM FINAL.py`)
- Frame capture → Hand tracking: processes frames (evidence: `ARM FINAL.py`)
- Hand tracking → Finger detection: supplies landmarks (evidence: `ARM FINAL.py`)
- Finger detection → Finger pattern: encodes states (evidence: `ARM FINAL.py`)
- Hand tracking → Tracking display: draws landmarks (evidence: `ARM FINAL.py`)
- Finger pattern → Serial link: sends pattern (evidence: `ARM FINAL.py`)
- Serial link → Arduino controller: transmits serial (evidence: `README.md`)
- Arduino controller → Finger servos: controls fingers (evidence: `README.md`)
- Finger servos → Bionic hand: moves fingers
