robovisionarm 0.1.0__tar.gz

robovisionarm-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Naman Lohiya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

robovisionarm-0.1.0/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: robovisionarm
+Version: 0.1.0
+Summary: Computer Vision Controlled DIY Robotic Arm
+Author: Naman Lohiya
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opencv-python
+Requires-Dist: mediapipe
+Requires-Dist: pyserial
+Dynamic: license-file
+
+# 🤖 RoboVisionArm
+
+![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)
+![License](https://img.shields.io/badge/License-MIT-green.svg)
+![Robotics](https://img.shields.io/badge/Field-Robotics-orange.svg)
+![Computer Vision](https://img.shields.io/badge/Technology-Computer%20Vision-red.svg)
+
+**RoboVisionArm** is a Python library that enables **real-time control of a DIY robotic arm using computer vision and hand gestures**.
+It uses **OpenCV**, **MediaPipe**, and **Arduino serial communication** to convert hand movements into robotic arm motion.
+
+This library is ideal for:
+
+* 🤖 DIY robotic arm projects
+* 🎓 Engineering and robotics students
+* 🧪 Science exhibitions and competitions
+* 🔬 Robotics and computer vision research
+* 🏭 Prototype automation systems
+
+---
+
+# 🎥 Demo Video
+
+Upload your demo video (`robotarm.mp4`) to your GitHub repository and embed it here.
+
+Example:
+
+```
+https://github.com/YOUR_USERNAME/robovisionarm/blob/main/robotarm.mp4
+```
+
+GitHub will automatically show a video player.
+
+---
+
+# 📦 Installation
+
+Install from PyPI:
+
+```
+pip install robovisionarm
+```
+
+Or install dependencies manually:
+
+```
+pip install opencv-python mediapipe pyserial
+```
+
+---
+
+# ⚡ Quick Start
+
+This is the fastest way to run your robotic arm:
+
+```python
+from robovisionarm import RoboVisionArm
+
+arm = RoboVisionArm(
+    port="COM3",        # Change to your Arduino port (example: COM3 or /dev/ttyUSB0)
+    camera_index=0,     # Default webcam
+    debug=False         # True = print angles only
+)
+
+arm.run()
+```
+
+Press **ESC** to safely exit.
+
+---
+
+# 🎮 Gesture Controls
+
+| Gesture                       | Robotic Arm Movement    |
+| ----------------------------- | ----------------------- |
+| Move hand LEFT / RIGHT        | Base rotation           |
+| Move hand UP / DOWN           | Shoulder movement       |
+| Move hand forward / backward  | Elbow movement          |
+| Extend index & middle fingers | Wrist rotation          |
+| Pinch thumb and index finger  | Open / Close gripper    |
+| No hand detected              | Return to home position |
+
+---
+
+# 🔌 Arduino Setup
+
+Upload this code to your Arduino:
+
+```cpp
+#include <Servo.h>
+
+Servo base;
+Servo shoulder;
+Servo elbow;
+Servo wrist;
+Servo gripper;
+
+void setup()
+{
+  Serial.begin(115200);
+
+  base.attach(3);
+  shoulder.attach(5);
+  elbow.attach(6);
+  wrist.attach(9);
+  gripper.attach(10);
+}
+
+void loop()
+{
+  if (Serial.available() >= 5)
+  {
+    base.write(Serial.read());
+    shoulder.write(Serial.read());
+    elbow.write(Serial.read());
+    wrist.write(Serial.read());
+    gripper.write(Serial.read());
+  }
+}
+```
+
+---
+
+# 🧠 How It Works
+
+1. Webcam captures live video
+2. MediaPipe detects hand landmarks
+3. Landmarks convert into servo angles
+4. Python sends angles via serial communication
+5. Arduino moves servo motors
+
+All of this happens in **real time**.
+
+---
+
+# 📂 Example Usage
+
+Run example script:
+
+```
+python examples/run_arm.py
+```
+
+---
+
+# ⚙️ Library Parameters
+
+```
+RoboVisionArm(
+    port="COM3",
+    camera_index=0,
+    debug=False
+)
+```
+
+| Parameter    | Description                     |
+| ------------ | ------------------------------- |
+| port         | Arduino serial port             |
+| camera_index | Webcam index                    |
+| debug        | Print angles instead of sending |
+
+---
+
+# 🦾 Hardware Requirements
+
+* Arduino Uno / Nano / Mega
+* Servo motors (SG90, MG996R, etc.)
+* USB Webcam
+* DIY robotic arm
+* External power supply (recommended)
+
+---
+
+# 📊 Applications
+
+* Gesture-controlled robotic arms
+* Industrial robotic prototypes
+* Educational robotics labs
+* Computer vision research
+* Automation demonstrations
+
+---
+
+# 📁 Project Structure
+
+```
+robovisionarm/
+│
+├── robovisionarm/
+│   ├── controller.py
+│   ├── gestures.py
+│   ├── serial_comm.py
+│   ├── config.py
+│
+├── examples/
+│   └── run_arm.py
+│
+├── README.md
+├── LICENSE
+├── pyproject.toml
+└── setup.py
+```
+
+---
+
+# 🧑‍💻 Author
+
+**Naman Lohiya**
+Robotics and Computer Vision Developer
+
+---
+
+# 📜 License
+
+MIT License
+
+---
+
+# ⭐ Support
+
+If you like this project, consider starring the GitHub repository and sharing it with the robotics community.
+  

robovisionarm-0.1.0/README.md

@@ -0,0 +1,221 @@
+# 🤖 RoboVisionArm
+
+![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)
+![License](https://img.shields.io/badge/License-MIT-green.svg)
+![Robotics](https://img.shields.io/badge/Field-Robotics-orange.svg)
+![Computer Vision](https://img.shields.io/badge/Technology-Computer%20Vision-red.svg)
+
+**RoboVisionArm** is a Python library that enables **real-time control of a DIY robotic arm using computer vision and hand gestures**.
+It uses **OpenCV**, **MediaPipe**, and **Arduino serial communication** to convert hand movements into robotic arm motion.
+
+This library is ideal for:
+
+* 🤖 DIY robotic arm projects
+* 🎓 Engineering and robotics students
+* 🧪 Science exhibitions and competitions
+* 🔬 Robotics and computer vision research
+* 🏭 Prototype automation systems
+
+---
+
+# 🎥 Demo Video
+
+Upload your demo video (`robotarm.mp4`) to your GitHub repository and embed it here.
+
+Example:
+
+```
+https://github.com/YOUR_USERNAME/robovisionarm/blob/main/robotarm.mp4
+```
+
+GitHub will automatically show a video player.
+
+---
+
+# 📦 Installation
+
+Install from PyPI:
+
+```
+pip install robovisionarm
+```
+
+Or install dependencies manually:
+
+```
+pip install opencv-python mediapipe pyserial
+```
+
+---
+
+# ⚡ Quick Start
+
+This is the fastest way to run your robotic arm:
+
+```python
+from robovisionarm import RoboVisionArm
+
+arm = RoboVisionArm(
+    port="COM3",        # Change to your Arduino port (example: COM3 or /dev/ttyUSB0)
+    camera_index=0,     # Default webcam
+    debug=False         # True = print angles only
+)
+
+arm.run()
+```
+
+Press **ESC** to safely exit.
+
+---
+
+# 🎮 Gesture Controls
+
+| Gesture                       | Robotic Arm Movement    |
+| ----------------------------- | ----------------------- |
+| Move hand LEFT / RIGHT        | Base rotation           |
+| Move hand UP / DOWN           | Shoulder movement       |
+| Move hand forward / backward  | Elbow movement          |
+| Extend index & middle fingers | Wrist rotation          |
+| Pinch thumb and index finger  | Open / Close gripper    |
+| No hand detected              | Return to home position |
+
+---
+
+# 🔌 Arduino Setup
+
+Upload this code to your Arduino:
+
+```cpp
+#include <Servo.h>
+
+Servo base;
+Servo shoulder;
+Servo elbow;
+Servo wrist;
+Servo gripper;
+
+void setup()
+{
+  Serial.begin(115200);
+
+  base.attach(3);
+  shoulder.attach(5);
+  elbow.attach(6);
+  wrist.attach(9);
+  gripper.attach(10);
+}
+
+void loop()
+{
+  if (Serial.available() >= 5)
+  {
+    base.write(Serial.read());
+    shoulder.write(Serial.read());
+    elbow.write(Serial.read());
+    wrist.write(Serial.read());
+    gripper.write(Serial.read());
+  }
+}
+```
+
+---
+
+# 🧠 How It Works
+
+1. Webcam captures live video
+2. MediaPipe detects hand landmarks
+3. Landmarks convert into servo angles
+4. Python sends angles via serial communication
+5. Arduino moves servo motors
+
+All of this happens in **real time**.
+
+---
+
+# 📂 Example Usage
+
+Run example script:
+
+```
+python examples/run_arm.py
+```
+
+---
+
+# ⚙️ Library Parameters
+
+```
+RoboVisionArm(
+    port="COM3",
+    camera_index=0,
+    debug=False
+)
+```
+
+| Parameter    | Description                     |
+| ------------ | ------------------------------- |
+| port         | Arduino serial port             |
+| camera_index | Webcam index                    |
+| debug        | Print angles instead of sending |
+
+---
+
+# 🦾 Hardware Requirements
+
+* Arduino Uno / Nano / Mega
+* Servo motors (SG90, MG996R, etc.)
+* USB Webcam
+* DIY robotic arm
+* External power supply (recommended)
+
+---
+
+# 📊 Applications
+
+* Gesture-controlled robotic arms
+* Industrial robotic prototypes
+* Educational robotics labs
+* Computer vision research
+* Automation demonstrations
+
+---
+
+# 📁 Project Structure
+
+```
+robovisionarm/
+│
+├── robovisionarm/
+│   ├── controller.py
+│   ├── gestures.py
+│   ├── serial_comm.py
+│   ├── config.py
+│
+├── examples/
+│   └── run_arm.py
+│
+├── README.md
+├── LICENSE
+├── pyproject.toml
+└── setup.py
+```
+
+---
+
+# 🧑‍💻 Author
+
+**Naman Lohiya**
+Robotics and Computer Vision Developer
+
+---
+
+# 📜 License
+
+MIT License
+
+---
+
+# ⭐ Support
+
+If you like this project, consider starring the GitHub repository and sharing it with the robotics community.
+  

robovisionarm-0.1.0/examples/run_arm.py

@@ -0,0 +1,9 @@
+from robovisionarm import RoboVisionArm
+
+arm = RoboVisionArm(
+
+    port="COM3",
+    camera_index=0
+)
+
+arm.run()

robovisionarm-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "robovisionarm"
+version = "0.1.0"
+description = "Computer Vision Controlled DIY Robotic Arm"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+  { name = "Naman Lohiya" }
+]
+
+license = "MIT"
+
+dependencies = [
+  "opencv-python",
+  "mediapipe",
+  "pyserial"
+]
+
+[tool.setuptools.packages.find]
+where = ["."]

robovisionarm-0.1.0/robovisionarm/__init__.py

@@ -0,0 +1 @@
+from .controller import RoboVisionArm

robovisionarm-0.1.0/robovisionarm/config.py

@@ -0,0 +1,12 @@
+HOME_POSITION = [90, 90, 90, 60, 90]
+
+SERVO_LIMITS = {
+    "base": (0, 180),
+    "shoulder": (0, 180),
+    "elbow": (10, 180),
+    "wrist": (0, 120),
+    "gripper": (0, 180),
+}
+
+SMOOTHING_ALPHA = 0.3
+SEND_INTERVAL = 0.05

robovisionarm-0.1.0/robovisionarm/controller.py

@@ -0,0 +1,104 @@
+import cv2
+import mediapipe as mp
+import time
+
+from .serial_comm import ArduinoController
+from .config import HOME_POSITION
+
+
+class RoboVisionArm:
+
+    def __init__(
+
+        self,
+        port="COM3",
+        camera_index=0,
+        debug=False
+    ):
+
+        self.arduino = ArduinoController(port, debug=debug)
+
+        self.cap = cv2.VideoCapture(camera_index)
+
+        self.current_angles = HOME_POSITION.copy()
+
+        self.mp_hands = mp.solutions.hands.Hands(
+            min_detection_confidence=0.5,
+            min_tracking_confidence=0.5
+        )
+
+
+    def compute_angles(self, hand):
+
+        wrist = hand.landmark[0]
+
+        base = int(wrist.x * 180)
+
+        shoulder = int(wrist.y * 180)
+
+        elbow = 90
+
+        wrist_rot = 60
+
+        gripper = 90
+
+        return [
+
+            base,
+            shoulder,
+            elbow,
+            wrist_rot,
+            gripper
+        ]
+
+
+    def step(self):
+
+        success, frame = self.cap.read()
+
+        if not success:
+            return True
+
+        rgb = cv2.cvtColor(frame, cv2.COLOR_BGR2RGB)
+
+        results = self.mp_hands.process(rgb)
+
+        if results.multi_hand_landmarks:
+
+            hand = results.multi_hand_landmarks[0]
+
+            angles = self.compute_angles(hand)
+
+            self.current_angles = angles
+
+            self.arduino.send_angles(angles)
+
+        cv2.imshow("RoboVisionArm", frame)
+
+        if cv2.waitKey(1) == 27:
+            return False
+
+        return True
+
+
+    def run(self):
+
+        print("Starting RoboVisionArm...")
+
+        while True:
+
+            if not self.step():
+                break
+
+        self.shutdown()
+
+
+    def shutdown(self):
+
+        print("Shutting down")
+
+        self.cap.release()
+
+        self.arduino.close()
+
+        cv2.destroyAllWindows()

robovisionarm-0.1.0/robovisionarm/gestures.py

@@ -0,0 +1,39 @@
+import math
+
+def clamp(x, min_val, max_val):
+
+    return max(min_val, min(x, max_val))
+
+
+def map_range(x, in_min, in_max, out_min, out_max):
+
+    return int(
+        (x - in_min)
+        * (out_max - out_min)
+        / (in_max - in_min)
+        + out_min
+    )
+
+
+def palm_size(hand):
+
+    wrist = hand.landmark[0]
+    index = hand.landmark[5]
+
+    return math.sqrt(
+        (wrist.x-index.x)**2 +
+        (wrist.y-index.y)**2 +
+        (wrist.z-index.z)**2
+    )
+
+
+def pinch_distance(hand):
+
+    thumb = hand.landmark[4]
+    index = hand.landmark[8]
+
+    return math.sqrt(
+        (thumb.x-index.x)**2 +
+        (thumb.y-index.y)**2 +
+        (thumb.z-index.z)**2
+    )

robovisionarm-0.1.0/robovisionarm/serial_comm.py

@@ -0,0 +1,35 @@
+import serial
+
+class ArduinoController:
+
+    def __init__(self, port="COM3", baudrate=115200, debug=False):
+
+        self.debug = debug
+        self.ser = None
+
+        if not debug:
+
+            try:
+                self.ser = serial.Serial(port, baudrate, timeout=1)
+                print(f"Connected to Arduino on {port}")
+
+            except Exception as e:
+
+                print("Serial failed → Debug mode:", e)
+                self.debug = True
+
+
+    def send_angles(self, angles):
+
+        if self.debug:
+
+            print("DEBUG ANGLES:", angles)
+            return
+
+        self.ser.write(bytearray([int(a) for a in angles]))
+
+
+    def close(self):
+
+        if self.ser:
+            self.ser.close()

robovisionarm-0.1.0/robovisionarm.egg-info/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: robovisionarm
+Version: 0.1.0
+Summary: Computer Vision Controlled DIY Robotic Arm
+Author: Naman Lohiya
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opencv-python
+Requires-Dist: mediapipe
+Requires-Dist: pyserial
+Dynamic: license-file
+
+# 🤖 RoboVisionArm
+
+![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)
+![License](https://img.shields.io/badge/License-MIT-green.svg)
+![Robotics](https://img.shields.io/badge/Field-Robotics-orange.svg)
+![Computer Vision](https://img.shields.io/badge/Technology-Computer%20Vision-red.svg)
+
+**RoboVisionArm** is a Python library that enables **real-time control of a DIY robotic arm using computer vision and hand gestures**.
+It uses **OpenCV**, **MediaPipe**, and **Arduino serial communication** to convert hand movements into robotic arm motion.
+
+This library is ideal for:
+
+* 🤖 DIY robotic arm projects
+* 🎓 Engineering and robotics students
+* 🧪 Science exhibitions and competitions
+* 🔬 Robotics and computer vision research
+* 🏭 Prototype automation systems
+
+---
+
+# 🎥 Demo Video
+
+Upload your demo video (`robotarm.mp4`) to your GitHub repository and embed it here.
+
+Example:
+
+```
+https://github.com/YOUR_USERNAME/robovisionarm/blob/main/robotarm.mp4
+```
+
+GitHub will automatically show a video player.
+
+---
+
+# 📦 Installation
+
+Install from PyPI:
+
+```
+pip install robovisionarm
+```
+
+Or install dependencies manually:
+
+```
+pip install opencv-python mediapipe pyserial
+```
+
+---
+
+# ⚡ Quick Start
+
+This is the fastest way to run your robotic arm:
+
+```python
+from robovisionarm import RoboVisionArm
+
+arm = RoboVisionArm(
+    port="COM3",        # Change to your Arduino port (example: COM3 or /dev/ttyUSB0)
+    camera_index=0,     # Default webcam
+    debug=False         # True = print angles only
+)
+
+arm.run()
+```
+
+Press **ESC** to safely exit.
+
+---
+
+# 🎮 Gesture Controls
+
+| Gesture                       | Robotic Arm Movement    |
+| ----------------------------- | ----------------------- |
+| Move hand LEFT / RIGHT        | Base rotation           |
+| Move hand UP / DOWN           | Shoulder movement       |
+| Move hand forward / backward  | Elbow movement          |
+| Extend index & middle fingers | Wrist rotation          |
+| Pinch thumb and index finger  | Open / Close gripper    |
+| No hand detected              | Return to home position |
+
+---
+
+# 🔌 Arduino Setup
+
+Upload this code to your Arduino:
+
+```cpp
+#include <Servo.h>
+
+Servo base;
+Servo shoulder;
+Servo elbow;
+Servo wrist;
+Servo gripper;
+
+void setup()
+{
+  Serial.begin(115200);
+
+  base.attach(3);
+  shoulder.attach(5);
+  elbow.attach(6);
+  wrist.attach(9);
+  gripper.attach(10);
+}
+
+void loop()
+{
+  if (Serial.available() >= 5)
+  {
+    base.write(Serial.read());
+    shoulder.write(Serial.read());
+    elbow.write(Serial.read());
+    wrist.write(Serial.read());
+    gripper.write(Serial.read());
+  }
+}
+```
+
+---
+
+# 🧠 How It Works
+
+1. Webcam captures live video
+2. MediaPipe detects hand landmarks
+3. Landmarks convert into servo angles
+4. Python sends angles via serial communication
+5. Arduino moves servo motors
+
+All of this happens in **real time**.
+
+---
+
+# 📂 Example Usage
+
+Run example script:
+
+```
+python examples/run_arm.py
+```
+
+---
+
+# ⚙️ Library Parameters
+
+```
+RoboVisionArm(
+    port="COM3",
+    camera_index=0,
+    debug=False
+)
+```
+
+| Parameter    | Description                     |
+| ------------ | ------------------------------- |
+| port         | Arduino serial port             |
+| camera_index | Webcam index                    |
+| debug        | Print angles instead of sending |
+
+---
+
+# 🦾 Hardware Requirements
+
+* Arduino Uno / Nano / Mega
+* Servo motors (SG90, MG996R, etc.)
+* USB Webcam
+* DIY robotic arm
+* External power supply (recommended)
+
+---
+
+# 📊 Applications
+
+* Gesture-controlled robotic arms
+* Industrial robotic prototypes
+* Educational robotics labs
+* Computer vision research
+* Automation demonstrations
+
+---
+
+# 📁 Project Structure
+
+```
+robovisionarm/
+│
+├── robovisionarm/
+│   ├── controller.py
+│   ├── gestures.py
+│   ├── serial_comm.py
+│   ├── config.py
+│
+├── examples/
+│   └── run_arm.py
+│
+├── README.md
+├── LICENSE
+├── pyproject.toml
+└── setup.py
+```
+
+---
+
+# 🧑‍💻 Author
+
+**Naman Lohiya**
+Robotics and Computer Vision Developer
+
+---
+
+# 📜 License
+
+MIT License
+
+---
+
+# ⭐ Support
+
+If you like this project, consider starring the GitHub repository and sharing it with the robotics community.
+  

robovisionarm-0.1.0/robovisionarm.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+examples/run_arm.py
+robovisionarm/__init__.py
+robovisionarm/config.py
+robovisionarm/controller.py
+robovisionarm/gestures.py
+robovisionarm/serial_comm.py
+robovisionarm.egg-info/PKG-INFO
+robovisionarm.egg-info/SOURCES.txt
+robovisionarm.egg-info/dependency_links.txt
+robovisionarm.egg-info/requires.txt
+robovisionarm.egg-info/top_level.txt

robovisionarm-0.1.0/robovisionarm.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

robovisionarm-0.1.0/robovisionarm.egg-info/requires.txt

@@ -0,0 +1,3 @@
+opencv-python
+mediapipe
+pyserial

robovisionarm-0.1.0/robovisionarm.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+dist
+examples
+robovisionarm

robovisionarm-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

robovisionarm-0.1.0/setup.py

@@ -0,0 +1,7 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="robovisionarm",
+    version="0.1.0",
+    packages=find_packages(),
+)