ai-virtual-mouse-controller 1.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. ai_virtual_mouse_controller-1.0.1/LICENSE +21 -0
  2. ai_virtual_mouse_controller-1.0.1/PKG-INFO +130 -0
  3. ai_virtual_mouse_controller-1.0.1/README.md +87 -0
  4. ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/PKG-INFO +130 -0
  5. ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/SOURCES.txt +38 -0
  6. ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/dependency_links.txt +1 -0
  7. ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/entry_points.txt +2 -0
  8. ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/requires.txt +15 -0
  9. ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/top_level.txt +4 -0
  10. ai_virtual_mouse_controller-1.0.1/config.py +550 -0
  11. ai_virtual_mouse_controller-1.0.1/core/__init__.py +14 -0
  12. ai_virtual_mouse_controller-1.0.1/core/camera.py +205 -0
  13. ai_virtual_mouse_controller-1.0.1/core/click_burst.py +206 -0
  14. ai_virtual_mouse_controller-1.0.1/core/cursor_controller.py +305 -0
  15. ai_virtual_mouse_controller-1.0.1/core/finger_posture.py +131 -0
  16. ai_virtual_mouse_controller-1.0.1/core/gesture_detector.py +1056 -0
  17. ai_virtual_mouse_controller-1.0.1/core/hand_anchor.py +358 -0
  18. ai_virtual_mouse_controller-1.0.1/core/hand_mesh.py +804 -0
  19. ai_virtual_mouse_controller-1.0.1/core/hand_renderer.py +421 -0
  20. ai_virtual_mouse_controller-1.0.1/core/hand_tracker.py +238 -0
  21. ai_virtual_mouse_controller-1.0.1/core/hologram_gl_backend.py +993 -0
  22. ai_virtual_mouse_controller-1.0.1/core/hologram_overlay.py +894 -0
  23. ai_virtual_mouse_controller-1.0.1/core/perf_telemetry.py +166 -0
  24. ai_virtual_mouse_controller-1.0.1/core/runtime_settings.py +310 -0
  25. ai_virtual_mouse_controller-1.0.1/core/smoothing.py +233 -0
  26. ai_virtual_mouse_controller-1.0.1/core/ui_overlay.py +748 -0
  27. ai_virtual_mouse_controller-1.0.1/core/utils.py +126 -0
  28. ai_virtual_mouse_controller-1.0.1/main.py +47 -0
  29. ai_virtual_mouse_controller-1.0.1/pyproject.toml +240 -0
  30. ai_virtual_mouse_controller-1.0.1/services/__init__.py +1 -0
  31. ai_virtual_mouse_controller-1.0.1/services/virtual_mouse_service.py +839 -0
  32. ai_virtual_mouse_controller-1.0.1/setup.cfg +4 -0
  33. ai_virtual_mouse_controller-1.0.1/tests/test_click_burst.py +163 -0
  34. ai_virtual_mouse_controller-1.0.1/tests/test_cursor_click_at.py +116 -0
  35. ai_virtual_mouse_controller-1.0.1/tests/test_gesture_detector.py +411 -0
  36. ai_virtual_mouse_controller-1.0.1/tests/test_hand_renderer.py +310 -0
  37. ai_virtual_mouse_controller-1.0.1/tests/test_hologram_overlay.py +224 -0
  38. ai_virtual_mouse_controller-1.0.1/tests/test_overlay_smoke.py +149 -0
  39. ai_virtual_mouse_controller-1.0.1/tests/test_perf_telemetry.py +156 -0
  40. ai_virtual_mouse_controller-1.0.1/tests/test_smoothing.py +149 -0
ai_virtual_mouse_controller-1.0.1/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Guilherme Moraes Franco
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.
ai_virtual_mouse_controller-1.0.1/PKG-INFO ADDED
@@ -0,0 +1,130 @@
1
+ Metadata-Version: 2.4
2
+ Name: ai-virtual-mouse-controller
3
+ Version: 1.0.1
4
+ Summary: Controle de cursor por gestos da mao via webcam, com holograma 3D opcional.
5
+ Author: Guilherme Moraes Franco
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/ognistie/ai-virtual-mouse-controller
8
+ Project-URL: Documentation, https://ognistie.github.io/ai-virtual-mouse-controller/
9
+ Project-URL: Issues, https://github.com/ognistie/ai-virtual-mouse-controller/issues
10
+ Project-URL: Discussions, https://github.com/ognistie/ai-virtual-mouse-controller/discussions
11
+ Project-URL: Changelog, https://github.com/ognistie/ai-virtual-mouse-controller/blob/main/CHANGELOG.md
12
+ Keywords: computer-vision,gesture-recognition,mediapipe,mouse-control,accessibility,hologram
13
+ Classifier: Development Status :: 3 - Alpha
14
+ Classifier: Environment :: Console
15
+ Classifier: Intended Audience :: End Users/Desktop
16
+ Classifier: License :: OSI Approved :: MIT License
17
+ Classifier: Operating System :: Microsoft :: Windows
18
+ Classifier: Operating System :: POSIX :: Linux
19
+ Classifier: Operating System :: MacOS :: MacOS X
20
+ Classifier: Programming Language :: Python :: 3
21
+ Classifier: Programming Language :: Python :: 3.11
22
+ Classifier: Programming Language :: Python :: 3.12
23
+ Classifier: Programming Language :: Python :: 3.13
24
+ Classifier: Topic :: Multimedia :: Video :: Capture
25
+ Classifier: Topic :: Scientific/Engineering :: Image Recognition
26
+ Requires-Python: <3.14,>=3.11
27
+ Description-Content-Type: text/markdown
28
+ License-File: LICENSE
29
+ Requires-Dist: opencv-python<5.0.0,>=4.10.0
30
+ Requires-Dist: mediapipe<0.11.0,>=0.10.18
31
+ Requires-Dist: pyautogui<1.0.0,>=0.9.54
32
+ Requires-Dist: numpy<2.2.0,>=1.26.0
33
+ Provides-Extra: hologram
34
+ Requires-Dist: moderngl>=5.10.0; extra == "hologram"
35
+ Requires-Dist: PySide6>=6.6.0; extra == "hologram"
36
+ Provides-Extra: dev
37
+ Requires-Dist: pytest>=8.0.0; extra == "dev"
38
+ Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
39
+ Requires-Dist: ruff>=0.4.0; extra == "dev"
40
+ Requires-Dist: mypy>=1.10.0; extra == "dev"
41
+ Requires-Dist: pre-commit>=3.7.0; extra == "dev"
42
+ Dynamic: license-file
43
+
44
+ <div align="center">
45
+
46
+ # AI Virtual Mouse Controller
47
+
48
+ ### *Controle seu computador com gestos da mão.*
49
+
50
+ [![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)
51
+ ![Version](https://img.shields.io/badge/v0.2.0-22d3ee?style=flat-square)
52
+ ![Python](https://img.shields.io/badge/python_3.11+-22d3ee?style=flat-square)
53
+ ![License](https://img.shields.io/badge/MIT-22d3ee?style=flat-square)
54
+
55
+ Webcam → 21 landmarks → cursor do sistema. Sem hardware extra. Sem GPU.
56
+
57
+ <br/>
58
+
59
+ <table>
60
+ <tr>
61
+ <td align="center" width="20%"><img src="docs/assets/img/gesture_move_real.png" width="100%"/><br/><sub><b>🖐️ move</b></sub></td>
62
+ <td align="center" width="20%"><img src="docs/assets/img/gesture_left_click_real.png" width="100%"/><br/><sub><b>🤏 click</b></sub></td>
63
+ <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>
64
+ <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>
65
+ <td align="center" width="20%"><img src="docs/assets/img/gesture_pause_real.png" width="100%"/><br/><sub><b>✊ pausa</b></sub></td>
66
+ </tr>
67
+ </table>
68
+
69
+ <br/>
70
+
71
+ [**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)
72
+
73
+ </div>
74
+
75
+ ---
76
+
77
+ ## Comece
78
+
79
+ Requer **Python 3.11 ou 3.12** + webcam.
80
+
81
+ ```bash
82
+ pip install ai-virtual-mouse-controller
83
+ avmc
84
+ ```
85
+
86
+ Ou via clone:
87
+
88
+ ```powershell
89
+ git clone https://github.com/ognistie/ai-virtual-mouse-controller.git
90
+ cd ai-virtual-mouse-controller && py -3.11 -m venv .venv && .\.venv\Scripts\Activate.ps1
91
+ pip install -r requirements.txt && python main.py
92
+ ```
93
+
94
+ Posicione a mão a ~50cm da câmera. **`H`** liga o holograma · **`S`** abre o painel · **`ESC`** sai.
95
+
96
+ <details>
97
+ <summary><b>Pré-requisitos por OS</b></summary>
98
+
99
+ | OS | Setup adicional |
100
+ |---|---|
101
+ | **🪟 Windows 10/11** | Nada. Funciona out-of-the-box após `pip install`. |
102
+ | **🍎 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`. |
103
+ | **🐧 Linux (X11)** | `sudo apt install scrot python3-tk python3-dev` (Ubuntu/Debian). PyAutoGUI precisa desses pra capturar tela. |
104
+ | **🐧 Linux (Wayland)** | PyAutoGUI tem suporte limitado. Recomendado mudar pra sessão X11 ou rodar em modo headless de teste. |
105
+
106
+ Holograma 3D (opcional, ~500MB extra): `pip install "ai-virtual-mouse-controller[hologram]"`
107
+
108
+ </details>
109
+
110
+ ---
111
+
112
+ ## O que é
113
+
114
+ 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.
115
+
116
+ Stack: **Python 3.11+** · **OpenCV** · **MediaPipe** · **PyAutoGUI** · **NumPy** · **ModernGL** (opcional)
117
+
118
+ ---
119
+
120
+ <div align="center">
121
+
122
+ Quer entender a fundo? **[Documentação técnica →](https://ognistie.github.io/ai-virtual-mouse-controller/)**
123
+
124
+ 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)
125
+
126
+ <br/>
127
+
128
+ MIT © [Guilherme Moraes Franco](https://github.com/ognistie)
129
+
130
+ </div>
ai_virtual_mouse_controller-1.0.1/README.md ADDED
@@ -0,0 +1,87 @@
1
+ <div align="center">
2
+
3
+ # AI Virtual Mouse Controller
4
+
5
+ ### *Controle seu computador com gestos da mão.*
6
+
7
+ [![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)
8
+ ![Version](https://img.shields.io/badge/v0.2.0-22d3ee?style=flat-square)
9
+ ![Python](https://img.shields.io/badge/python_3.11+-22d3ee?style=flat-square)
10
+ ![License](https://img.shields.io/badge/MIT-22d3ee?style=flat-square)
11
+
12
+ Webcam → 21 landmarks → cursor do sistema. Sem hardware extra. Sem GPU.
13
+
14
+ <br/>
15
+
16
+ <table>
17
+ <tr>
18
+ <td align="center" width="20%"><img src="docs/assets/img/gesture_move_real.png" width="100%"/><br/><sub><b>🖐️ move</b></sub></td>
19
+ <td align="center" width="20%"><img src="docs/assets/img/gesture_left_click_real.png" width="100%"/><br/><sub><b>🤏 click</b></sub></td>
20
+ <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>
21
+ <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>
22
+ <td align="center" width="20%"><img src="docs/assets/img/gesture_pause_real.png" width="100%"/><br/><sub><b>✊ pausa</b></sub></td>
23
+ </tr>
24
+ </table>
25
+
26
+ <br/>
27
+
28
+ [**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)
29
+
30
+ </div>
31
+
32
+ ---
33
+
34
+ ## Comece
35
+
36
+ Requer **Python 3.11 ou 3.12** + webcam.
37
+
38
+ ```bash
39
+ pip install ai-virtual-mouse-controller
40
+ avmc
41
+ ```
42
+
43
+ Ou via clone:
44
+
45
+ ```powershell
46
+ git clone https://github.com/ognistie/ai-virtual-mouse-controller.git
47
+ cd ai-virtual-mouse-controller && py -3.11 -m venv .venv && .\.venv\Scripts\Activate.ps1
48
+ pip install -r requirements.txt && python main.py
49
+ ```
50
+
51
+ Posicione a mão a ~50cm da câmera. **`H`** liga o holograma · **`S`** abre o painel · **`ESC`** sai.
52
+
53
+ <details>
54
+ <summary><b>Pré-requisitos por OS</b></summary>
55
+
56
+ | OS | Setup adicional |
57
+ |---|---|
58
+ | **🪟 Windows 10/11** | Nada. Funciona out-of-the-box após `pip install`. |
59
+ | **🍎 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`. |
60
+ | **🐧 Linux (X11)** | `sudo apt install scrot python3-tk python3-dev` (Ubuntu/Debian). PyAutoGUI precisa desses pra capturar tela. |
61
+ | **🐧 Linux (Wayland)** | PyAutoGUI tem suporte limitado. Recomendado mudar pra sessão X11 ou rodar em modo headless de teste. |
62
+
63
+ Holograma 3D (opcional, ~500MB extra): `pip install "ai-virtual-mouse-controller[hologram]"`
64
+
65
+ </details>
66
+
67
+ ---
68
+
69
+ ## O que é
70
+
71
+ 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.
72
+
73
+ Stack: **Python 3.11+** · **OpenCV** · **MediaPipe** · **PyAutoGUI** · **NumPy** · **ModernGL** (opcional)
74
+
75
+ ---
76
+
77
+ <div align="center">
78
+
79
+ Quer entender a fundo? **[Documentação técnica →](https://ognistie.github.io/ai-virtual-mouse-controller/)**
80
+
81
+ 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)
82
+
83
+ <br/>
84
+
85
+ MIT © [Guilherme Moraes Franco](https://github.com/ognistie)
86
+
87
+ </div>
ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/PKG-INFO ADDED
@@ -0,0 +1,130 @@
1
+ Metadata-Version: 2.4
2
+ Name: ai-virtual-mouse-controller
3
+ Version: 1.0.1
4
+ Summary: Controle de cursor por gestos da mao via webcam, com holograma 3D opcional.
5
+ Author: Guilherme Moraes Franco
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/ognistie/ai-virtual-mouse-controller
8
+ Project-URL: Documentation, https://ognistie.github.io/ai-virtual-mouse-controller/
9
+ Project-URL: Issues, https://github.com/ognistie/ai-virtual-mouse-controller/issues
10
+ Project-URL: Discussions, https://github.com/ognistie/ai-virtual-mouse-controller/discussions
11
+ Project-URL: Changelog, https://github.com/ognistie/ai-virtual-mouse-controller/blob/main/CHANGELOG.md
12
+ Keywords: computer-vision,gesture-recognition,mediapipe,mouse-control,accessibility,hologram
13
+ Classifier: Development Status :: 3 - Alpha
14
+ Classifier: Environment :: Console
15
+ Classifier: Intended Audience :: End Users/Desktop
16
+ Classifier: License :: OSI Approved :: MIT License
17
+ Classifier: Operating System :: Microsoft :: Windows
18
+ Classifier: Operating System :: POSIX :: Linux
19
+ Classifier: Operating System :: MacOS :: MacOS X
20
+ Classifier: Programming Language :: Python :: 3
21
+ Classifier: Programming Language :: Python :: 3.11
22
+ Classifier: Programming Language :: Python :: 3.12
23
+ Classifier: Programming Language :: Python :: 3.13
24
+ Classifier: Topic :: Multimedia :: Video :: Capture
25
+ Classifier: Topic :: Scientific/Engineering :: Image Recognition
26
+ Requires-Python: <3.14,>=3.11
27
+ Description-Content-Type: text/markdown
28
+ License-File: LICENSE
29
+ Requires-Dist: opencv-python<5.0.0,>=4.10.0
30
+ Requires-Dist: mediapipe<0.11.0,>=0.10.18
31
+ Requires-Dist: pyautogui<1.0.0,>=0.9.54
32
+ Requires-Dist: numpy<2.2.0,>=1.26.0
33
+ Provides-Extra: hologram
34
+ Requires-Dist: moderngl>=5.10.0; extra == "hologram"
35
+ Requires-Dist: PySide6>=6.6.0; extra == "hologram"
36
+ Provides-Extra: dev
37
+ Requires-Dist: pytest>=8.0.0; extra == "dev"
38
+ Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
39
+ Requires-Dist: ruff>=0.4.0; extra == "dev"
40
+ Requires-Dist: mypy>=1.10.0; extra == "dev"
41
+ Requires-Dist: pre-commit>=3.7.0; extra == "dev"
42
+ Dynamic: license-file
43
+
44
+ <div align="center">
45
+
46
+ # AI Virtual Mouse Controller
47
+
48
+ ### *Controle seu computador com gestos da mão.*
49
+
50
+ [![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)
51
+ ![Version](https://img.shields.io/badge/v0.2.0-22d3ee?style=flat-square)
52
+ ![Python](https://img.shields.io/badge/python_3.11+-22d3ee?style=flat-square)
53
+ ![License](https://img.shields.io/badge/MIT-22d3ee?style=flat-square)
54
+
55
+ Webcam → 21 landmarks → cursor do sistema. Sem hardware extra. Sem GPU.
56
+
57
+ <br/>
58
+
59
+ <table>
60
+ <tr>
61
+ <td align="center" width="20%"><img src="docs/assets/img/gesture_move_real.png" width="100%"/><br/><sub><b>🖐️ move</b></sub></td>
62
+ <td align="center" width="20%"><img src="docs/assets/img/gesture_left_click_real.png" width="100%"/><br/><sub><b>🤏 click</b></sub></td>
63
+ <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>
64
+ <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>
65
+ <td align="center" width="20%"><img src="docs/assets/img/gesture_pause_real.png" width="100%"/><br/><sub><b>✊ pausa</b></sub></td>
66
+ </tr>
67
+ </table>
68
+
69
+ <br/>
70
+
71
+ [**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)
72
+
73
+ </div>
74
+
75
+ ---
76
+
77
+ ## Comece
78
+
79
+ Requer **Python 3.11 ou 3.12** + webcam.
80
+
81
+ ```bash
82
+ pip install ai-virtual-mouse-controller
83
+ avmc
84
+ ```
85
+
86
+ Ou via clone:
87
+
88
+ ```powershell
89
+ git clone https://github.com/ognistie/ai-virtual-mouse-controller.git
90
+ cd ai-virtual-mouse-controller && py -3.11 -m venv .venv && .\.venv\Scripts\Activate.ps1
91
+ pip install -r requirements.txt && python main.py
92
+ ```
93
+
94
+ Posicione a mão a ~50cm da câmera. **`H`** liga o holograma · **`S`** abre o painel · **`ESC`** sai.
95
+
96
+ <details>
97
+ <summary><b>Pré-requisitos por OS</b></summary>
98
+
99
+ | OS | Setup adicional |
100
+ |---|---|
101
+ | **🪟 Windows 10/11** | Nada. Funciona out-of-the-box após `pip install`. |
102
+ | **🍎 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`. |
103
+ | **🐧 Linux (X11)** | `sudo apt install scrot python3-tk python3-dev` (Ubuntu/Debian). PyAutoGUI precisa desses pra capturar tela. |
104
+ | **🐧 Linux (Wayland)** | PyAutoGUI tem suporte limitado. Recomendado mudar pra sessão X11 ou rodar em modo headless de teste. |
105
+
106
+ Holograma 3D (opcional, ~500MB extra): `pip install "ai-virtual-mouse-controller[hologram]"`
107
+
108
+ </details>
109
+
110
+ ---
111
+
112
+ ## O que é
113
+
114
+ 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.
115
+
116
+ Stack: **Python 3.11+** · **OpenCV** · **MediaPipe** · **PyAutoGUI** · **NumPy** · **ModernGL** (opcional)
117
+
118
+ ---
119
+
120
+ <div align="center">
121
+
122
+ Quer entender a fundo? **[Documentação técnica →](https://ognistie.github.io/ai-virtual-mouse-controller/)**
123
+
124
+ 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)
125
+
126
+ <br/>
127
+
128
+ MIT © [Guilherme Moraes Franco](https://github.com/ognistie)
129
+
130
+ </div>
ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,38 @@
1
+ LICENSE
2
+ README.md
3
+ config.py
4
+ main.py
5
+ pyproject.toml
6
+ ai_virtual_mouse_controller.egg-info/PKG-INFO
7
+ ai_virtual_mouse_controller.egg-info/SOURCES.txt
8
+ ai_virtual_mouse_controller.egg-info/dependency_links.txt
9
+ ai_virtual_mouse_controller.egg-info/entry_points.txt
10
+ ai_virtual_mouse_controller.egg-info/requires.txt
11
+ ai_virtual_mouse_controller.egg-info/top_level.txt
12
+ core/__init__.py
13
+ core/camera.py
14
+ core/click_burst.py
15
+ core/cursor_controller.py
16
+ core/finger_posture.py
17
+ core/gesture_detector.py
18
+ core/hand_anchor.py
19
+ core/hand_mesh.py
20
+ core/hand_renderer.py
21
+ core/hand_tracker.py
22
+ core/hologram_gl_backend.py
23
+ core/hologram_overlay.py
24
+ core/perf_telemetry.py
25
+ core/runtime_settings.py
26
+ core/smoothing.py
27
+ core/ui_overlay.py
28
+ core/utils.py
29
+ services/__init__.py
30
+ services/virtual_mouse_service.py
31
+ tests/test_click_burst.py
32
+ tests/test_cursor_click_at.py
33
+ tests/test_gesture_detector.py
34
+ tests/test_hand_renderer.py
35
+ tests/test_hologram_overlay.py
36
+ tests/test_overlay_smoke.py
37
+ tests/test_perf_telemetry.py
38
+ tests/test_smoothing.py
ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ avmc = main:main
ai_virtual_mouse_controller-1.0.1/ai_virtual_mouse_controller.egg-info/requires.txt ADDED
@@ -0,0 +1,15 @@
1
+ opencv-python<5.0.0,>=4.10.0
2
+ mediapipe<0.11.0,>=0.10.18
3
+ pyautogui<1.0.0,>=0.9.54
4
+ numpy<2.2.0,>=1.26.0
5
+
6
+ [dev]
7
+ pytest>=8.0.0
8
+ pytest-cov>=4.1.0
9
+ ruff>=0.4.0
10
+ mypy>=1.10.0
11
+ pre-commit>=3.7.0
12
+
13
+ [hologram]
14
+ moderngl>=5.10.0
15
+ PySide6>=6.6.0