ai-virtual-mouse-controller 1.0.1__py3-none-any.whl

ai_virtual_mouse_controller-1.0.1.dist-info/METADATA

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: ai-virtual-mouse-controller
+Version: 1.0.1
+Summary: Controle de cursor por gestos da mao via webcam, com holograma 3D opcional.
+Author: Guilherme Moraes Franco
+License: MIT
+Project-URL: Homepage, https://github.com/ognistie/ai-virtual-mouse-controller
+Project-URL: Documentation, https://ognistie.github.io/ai-virtual-mouse-controller/
+Project-URL: Issues, https://github.com/ognistie/ai-virtual-mouse-controller/issues
+Project-URL: Discussions, https://github.com/ognistie/ai-virtual-mouse-controller/discussions
+Project-URL: Changelog, https://github.com/ognistie/ai-virtual-mouse-controller/blob/main/CHANGELOG.md
+Keywords: computer-vision,gesture-recognition,mediapipe,mouse-control,accessibility,hologram
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Video :: Capture
+Classifier: Topic :: Scientific/Engineering :: Image Recognition
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opencv-python<5.0.0,>=4.10.0
+Requires-Dist: mediapipe<0.11.0,>=0.10.18
+Requires-Dist: pyautogui<1.0.0,>=0.9.54
+Requires-Dist: numpy<2.2.0,>=1.26.0
+Provides-Extra: hologram
+Requires-Dist: moderngl>=5.10.0; extra == "hologram"
+Requires-Dist: PySide6>=6.6.0; extra == "hologram"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: pre-commit>=3.7.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+# AI Virtual Mouse Controller
+
+### *Controle seu computador com gestos da mão.*
+
+[![CI](https://github.com/ognistie/ai-virtual-mouse-controller/actions/workflows/ci.yml/badge.svg)](https://github.com/ognistie/ai-virtual-mouse-controller/actions/workflows/ci.yml)
+![Version](https://img.shields.io/badge/v0.2.0-22d3ee?style=flat-square)
+![Python](https://img.shields.io/badge/python_3.11+-22d3ee?style=flat-square)
+![License](https://img.shields.io/badge/MIT-22d3ee?style=flat-square)
+
+Webcam → 21 landmarks → cursor do sistema. Sem hardware extra. Sem GPU.
+
+<br/>
+
+<table>
+<tr>
+<td align="center" width="20%"><img src="docs/assets/img/gesture_move_real.png" width="100%"/><br/><sub><b>🖐️ move</b></sub></td>
+<td align="center" width="20%"><img src="docs/assets/img/gesture_left_click_real.png" width="100%"/><br/><sub><b>🤏 click</b></sub></td>
+<td align="center" width="20%"><img src="docs/assets/img/gesture_right_click_real.png" width="100%"/><br/><sub><b>🤞 right click</b></sub></td>
+<td align="center" width="20%"><img src="docs/assets/img/gesture_double_click_real.png" width="100%"/><br/><sub><b>✌️ double click</b></sub></td>
+<td align="center" width="20%"><img src="docs/assets/img/gesture_pause_real.png" width="100%"/><br/><sub><b>✊ pausa</b></sub></td>
+</tr>
+</table>
+
+<br/>
+
+[**Site oficial →**](https://ognistie.github.io/ai-virtual-mouse-controller/) &nbsp;·&nbsp; [**Guia de uso →**](https://ognistie.github.io/ai-virtual-mouse-controller/usage.html)
+
+</div>
+
+---
+
+## Comece
+
+Requer **Python 3.11 ou 3.12** + webcam.
+
+```bash
+pip install ai-virtual-mouse-controller
+avmc
+```
+
+Ou via clone:
+
+```powershell
+git clone https://github.com/ognistie/ai-virtual-mouse-controller.git
+cd ai-virtual-mouse-controller && py -3.11 -m venv .venv && .\.venv\Scripts\Activate.ps1
+pip install -r requirements.txt && python main.py
+```
+
+Posicione a mão a ~50cm da câmera. **`H`** liga o holograma · **`S`** abre o painel · **`ESC`** sai.
+
+<details>
+<summary><b>Pré-requisitos por OS</b></summary>
+
+| OS | Setup adicional |
+|---|---|
+| **🪟 Windows 10/11** | Nada. Funciona out-of-the-box após `pip install`. |
+| **🍎 macOS** | Após primeiro run, libere acesso em **System Settings → Privacy & Security → Accessibility** (cursor) e **Camera** (webcam). Em Apple Silicon: se PyAutoGUI reclamar, `pip install pyobjc-core pyobjc`. |
+| **🐧 Linux (X11)** | `sudo apt install scrot python3-tk python3-dev` (Ubuntu/Debian). PyAutoGUI precisa desses pra capturar tela. |
+| **🐧 Linux (Wayland)** | PyAutoGUI tem suporte limitado. Recomendado mudar pra sessão X11 ou rodar em modo headless de teste. |
+
+Holograma 3D (opcional, ~500MB extra): `pip install "ai-virtual-mouse-controller[hologram]"`
+
+</details>
+
+---
+
+## O que é
+
+Sistema gestual de controle de cursor com qualidade comparável a periféricos físicos. MediaPipe identifica 21 pontos da sua mão em tempo real, uma state machine traduz gestos em comandos do SO, e um holograma 3D opcional renderiza tudo sobre o desktop.
+
+Stack: **Python 3.11+** · **OpenCV** · **MediaPipe** · **PyAutoGUI** · **NumPy** · **ModernGL** (opcional)
+
+---
+
+<div align="center">
+
+Quer entender a fundo? **[Documentação técnica →](https://ognistie.github.io/ai-virtual-mouse-controller/)**
+
+Quer contribuir? Leia [CONTRIBUTING.md](CONTRIBUTING.md) · Achou bug? [Abra issue](https://github.com/ognistie/ai-virtual-mouse-controller/issues/new?template=bug_report.yml)
+
+<br/>
+
+MIT © [Guilherme Moraes Franco](https://github.com/ognistie)
+
+</div>

ai_virtual_mouse_controller-1.0.1.dist-info/RECORD

@@ -0,0 +1,27 @@
+config.py,sha256=gvLoSc041b8Waf30fd-dHpSP2hXqOVnDOti7-6g4-oA,20158
+main.py,sha256=ltm4IPqL7ZHLOm5lUH3PsHyWO7DmMh5k_VSopdW57Lc,870
+ai_virtual_mouse_controller-1.0.1.dist-info/licenses/LICENSE,sha256=IhPSj9mmGIeKhqv2UEtLAZpD9wLqWj8hu-MLPUkUDVk,1080
+core/__init__.py,sha256=WRno_qdufyAhyaRRFuEUSnLInLnxyFXmVvyxlS0DtDE,495
+core/camera.py,sha256=swhGkNzpmisPVjket-B2214D-OGw65oyuMA5_EZjQac,5993
+core/click_burst.py,sha256=Aotd6piXXjjbYQfkpl0_yhaF6MLCqZ8s2gG8ZjNXHAk,6188
+core/cursor_controller.py,sha256=PSfP8SQEvGLVUOlAIv61fdYkzrlz1J8qop2cxB5FZ48,12100
+core/finger_posture.py,sha256=AJ_3djtCk6W7HkBfpfFHAuh_bmXRYxmo6bUsTNRn8ME,4757
+core/gesture_detector.py,sha256=35N_7qqNLTP7MXk3-6kTbXb7v5hpiocw429haqogtj4,41412
+core/hand_anchor.py,sha256=rsnwqfZes2j30kFSnxY6IR-To0cgcZENq-oTOVhqK8U,13693
+core/hand_mesh.py,sha256=IpCb3MMJrN-t29qnKJiMHhyxDSiO_vsP2dm0l-mixMM,31621
+core/hand_renderer.py,sha256=Ql4LkZ6C9lDkbKurMxohMWojt-hoKcIO75zgvVoydAM,14104
+core/hand_tracker.py,sha256=5vZC-WVBLWueqp1fmyyK7N2WipGK9jifyvmRSc2RN44,7785
+core/hologram_gl_backend.py,sha256=RZJcz2TAVdydnvK_kvD9UyTS9td9aOJQaqPdy6X45dk,38245
+core/hologram_overlay.py,sha256=vh-zPYOXjDhxk3aU_THxM46CsXYd3caEDtJHOWYIvb0,35482
+core/perf_telemetry.py,sha256=uiNePOGIUlity2cu9-9pDG9nYFCEaOPgZNlvfhi-LT4,4501
+core/runtime_settings.py,sha256=vrLN0YRVvUzB46jjr03l0ymYPgj0satqTOmX_SFNRuE,10201
+core/smoothing.py,sha256=L6haqe22GTE_rT_0OYAVsKISXcBMPUVct8jE4DqBd2w,6904
+core/ui_overlay.py,sha256=_yP-fi1MWXZ9I9cX2OnTLYFEwvD9ejJIo_1-Ij_Hbeo,26515
+core/utils.py,sha256=nhHQ9EEvOaoqZIFNWM9S5AEAKjNbrSfLW6r7Qz9lwcg,2981
+services/__init__.py,sha256=sUrXql5dOIwixikpUrzP7K6-8abt_bZYQKz4e_5xaF0,61
+services/virtual_mouse_service.py,sha256=1y8buSlc3eZkwpQwQfaPGHFNJEuPmvqEDYvV_C_KVvw,34670
+ai_virtual_mouse_controller-1.0.1.dist-info/METADATA,sha256=zdH1jbACdJAEUEjAm7gAW88nMbtT11GpI7q-O6AEY-c,5593
+ai_virtual_mouse_controller-1.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+ai_virtual_mouse_controller-1.0.1.dist-info/entry_points.txt,sha256=BlTyRy0NZcJPuPj24plwhuxbOfSHZgx4V99nVVJlgxg,35
+ai_virtual_mouse_controller-1.0.1.dist-info/top_level.txt,sha256=hHvvSk8Zy7WIY2Qp7-Gk3FOICSwQjZLZ3lY-RX4wnMo,26
+ai_virtual_mouse_controller-1.0.1.dist-info/RECORD,,

ai_virtual_mouse_controller-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ai_virtual_mouse_controller-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+avmc = main:main

ai_virtual_mouse_controller-1.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guilherme Moraes Franco
+
+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.

ai_virtual_mouse_controller-1.0.1.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+config
+core
+main
+services