hand-tracking-teleop 0.1.0__tar.gz → 0.1.1__tar.gz

hand_tracking_teleop-0.1.1/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: hand_tracking_teleop
+Version: 0.1.1
+Summary: Hand tracking system for robot teleoperation using MediaPipe
+Home-page: https://github.com/yourusername/hand_tracking_teleop
+Author: Bruk Gebregziabher
+Author-email: Bruk Gebregziabher <bruk@signalbotics.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/hand_tracking_teleop
+Project-URL: Documentation, https://github.com/yourusername/hand_tracking_teleop#readme
+Project-URL: Repository, https://github.com/yourusername/hand_tracking_teleop
+Project-URL: Bug Tracker, https://github.com/yourusername/hand_tracking_teleop/issues
+Keywords: hand-tracking,teleoperation,robotics,mediapipe,computer-vision
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: opencv-python>=4.5.0
+Requires-Dist: mediapipe>=0.10.0
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: vis
+Requires-Dist: matplotlib>=3.5.0; extra == "vis"
+Provides-Extra: rerun
+Requires-Dist: rerun-sdk>=0.18.0; extra == "rerun"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: flake8>=6.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: isort>=5.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# Hand Tracking Teleop
+
+Real-time hand tracking for robot teleoperation using MediaPipe.
+
+## Features
+
+- 21 hand landmarks per hand at 30fps
+- Calibrated metric-space normalization
+- Multiple visualization modes (2D, 3D, Rerun)
+- Finger articulation tracking with curl detection
+- Temporal smoothing for stable tracking
+
+## Installation
+
+```bash
+pip install hand-tracking-teleop
+```
+
+With visualization support:
+
+```bash
+pip install hand-tracking-teleop[vis]
+```
+
+## Quick Start
+
+### CLI
+
+```bash
+# Interactive mode (choose visualization)
+hand-track
+
+# Direct visualization modes
+hand-track --mode 2d      # OpenCV window
+hand-track --mode 3d      # Matplotlib 3D view
+hand-track --mode rerun   # Rerun viewer
+```
+
+### Python API
+
+```python
+from hand_tracking import HandDetector
+
+detector = HandDetector()
+
+# Run interactive visualization
+detector.run_interactive(mode='3d')
+
+# Or process frames manually
+import cv2
+cap = cv2.VideoCapture(0)
+
+while True:
+    ret, frame = cap.read()
+    if not ret:
+        break
+
+    results = detector.detect(frame)
+    for hand in results:
+        print(f"Hand: {hand.handedness}, landmarks: {len(hand.landmarks)}")
+```
+
+## Controls
+
+- **q**: Quit (2D view)
+- **Mouse drag**: Rotate 3D view
+- **Scroll**: Zoom
+- **Right-click drag**: Pan
+
+## Documentation
+
+- [Installation Guide](INSTALL.md) - Detailed setup instructions
+- [3D Visualization Quick Start](QUICKSTART_3D.md) - Get started with 3D views
+- [Visualization Guide](VISUALIZATION_GUIDE.md) - All visualization options
+- [Technical Details](TECHNICAL.md) - Mathematical framework and coordinate mapping
+- [Roadmap](ROADMAP.md) - Future development plans
+
+## License
+
+Apache 2.0

hand_tracking_teleop-0.1.1/README.md

@@ -0,0 +1,80 @@
+# Hand Tracking Teleop
+
+Real-time hand tracking for robot teleoperation using MediaPipe.
+
+## Features
+
+- 21 hand landmarks per hand at 30fps
+- Calibrated metric-space normalization
+- Multiple visualization modes (2D, 3D, Rerun)
+- Finger articulation tracking with curl detection
+- Temporal smoothing for stable tracking
+
+## Installation
+
+```bash
+pip install hand-tracking-teleop
+```
+
+With visualization support:
+
+```bash
+pip install hand-tracking-teleop[vis]
+```
+
+## Quick Start
+
+### CLI
+
+```bash
+# Interactive mode (choose visualization)
+hand-track
+
+# Direct visualization modes
+hand-track --mode 2d      # OpenCV window
+hand-track --mode 3d      # Matplotlib 3D view
+hand-track --mode rerun   # Rerun viewer
+```
+
+### Python API
+
+```python
+from hand_tracking import HandDetector
+
+detector = HandDetector()
+
+# Run interactive visualization
+detector.run_interactive(mode='3d')
+
+# Or process frames manually
+import cv2
+cap = cv2.VideoCapture(0)
+
+while True:
+    ret, frame = cap.read()
+    if not ret:
+        break
+
+    results = detector.detect(frame)
+    for hand in results:
+        print(f"Hand: {hand.handedness}, landmarks: {len(hand.landmarks)}")
+```
+
+## Controls
+
+- **q**: Quit (2D view)
+- **Mouse drag**: Rotate 3D view
+- **Scroll**: Zoom
+- **Right-click drag**: Pan
+
+## Documentation
+
+- [Installation Guide](INSTALL.md) - Detailed setup instructions
+- [3D Visualization Quick Start](QUICKSTART_3D.md) - Get started with 3D views
+- [Visualization Guide](VISUALIZATION_GUIDE.md) - All visualization options
+- [Technical Details](TECHNICAL.md) - Mathematical framework and coordinate mapping
+- [Roadmap](ROADMAP.md) - Future development plans
+
+## License
+
+Apache 2.0

{hand_tracking_teleop-0.1.0 → hand_tracking_teleop-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hand_tracking_teleop"
-version = "0.1.0"
+version = "0.1.1"
 description = "Hand tracking system for robot teleoperation using MediaPipe"
 readme = "README.md"
 requires-python = ">=3.8"

{hand_tracking_teleop-0.1.0 → hand_tracking_teleop-0.1.1}/setup.py

@@ -15,7 +15,7 @@ with open('requirements.txt') as f:
 
 setup(
     name="hand_tracking_teleop",
-    version="0.1.0",
+    version="0.1.1",
     author="Bruk Gebregziabher",
     author_email="bruk@signalbotics.com",
     description="Hand tracking system for robot teleoperation using MediaPipe",

{hand_tracking_teleop-0.1.0 → hand_tracking_teleop-0.1.1}/src/hand_tracking/__init__.py

@@ -4,7 +4,7 @@ This package provides real-time hand tracking using MediaPipe with
 scale-invariant 3D coordinate normalization for robust robot control.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 __author__ = "Bruk Gebregziabher"
 __email__ = "bruk@signalbotics.com"
 

hand_tracking_teleop-0.1.1/src/hand_tracking_teleop.egg-info/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: hand_tracking_teleop
+Version: 0.1.1
+Summary: Hand tracking system for robot teleoperation using MediaPipe
+Home-page: https://github.com/yourusername/hand_tracking_teleop
+Author: Bruk Gebregziabher
+Author-email: Bruk Gebregziabher <bruk@signalbotics.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/hand_tracking_teleop
+Project-URL: Documentation, https://github.com/yourusername/hand_tracking_teleop#readme
+Project-URL: Repository, https://github.com/yourusername/hand_tracking_teleop
+Project-URL: Bug Tracker, https://github.com/yourusername/hand_tracking_teleop/issues
+Keywords: hand-tracking,teleoperation,robotics,mediapipe,computer-vision
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: opencv-python>=4.5.0
+Requires-Dist: mediapipe>=0.10.0
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: vis
+Requires-Dist: matplotlib>=3.5.0; extra == "vis"
+Provides-Extra: rerun
+Requires-Dist: rerun-sdk>=0.18.0; extra == "rerun"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: flake8>=6.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: isort>=5.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# Hand Tracking Teleop
+
+Real-time hand tracking for robot teleoperation using MediaPipe.
+
+## Features
+
+- 21 hand landmarks per hand at 30fps
+- Calibrated metric-space normalization
+- Multiple visualization modes (2D, 3D, Rerun)
+- Finger articulation tracking with curl detection
+- Temporal smoothing for stable tracking
+
+## Installation
+
+```bash
+pip install hand-tracking-teleop
+```
+
+With visualization support:
+
+```bash
+pip install hand-tracking-teleop[vis]
+```
+
+## Quick Start
+
+### CLI
+
+```bash
+# Interactive mode (choose visualization)
+hand-track
+
+# Direct visualization modes
+hand-track --mode 2d      # OpenCV window
+hand-track --mode 3d      # Matplotlib 3D view
+hand-track --mode rerun   # Rerun viewer
+```
+
+### Python API
+
+```python
+from hand_tracking import HandDetector
+
+detector = HandDetector()
+
+# Run interactive visualization
+detector.run_interactive(mode='3d')
+
+# Or process frames manually
+import cv2
+cap = cv2.VideoCapture(0)
+
+while True:
+    ret, frame = cap.read()
+    if not ret:
+        break
+
+    results = detector.detect(frame)
+    for hand in results:
+        print(f"Hand: {hand.handedness}, landmarks: {len(hand.landmarks)}")
+```
+
+## Controls
+
+- **q**: Quit (2D view)
+- **Mouse drag**: Rotate 3D view
+- **Scroll**: Zoom
+- **Right-click drag**: Pan
+
+## Documentation
+
+- [Installation Guide](INSTALL.md) - Detailed setup instructions
+- [3D Visualization Quick Start](QUICKSTART_3D.md) - Get started with 3D views
+- [Visualization Guide](VISUALIZATION_GUIDE.md) - All visualization options
+- [Technical Details](TECHNICAL.md) - Mathematical framework and coordinate mapping
+- [Roadmap](ROADMAP.md) - Future development plans
+
+## License
+
+Apache 2.0