ai-virtual-mouse-controller 1.2.0__tar.gz → 1.4.0__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 (74) hide show
  1. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/PKG-INFO +34 -11
  2. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/README.md +33 -8
  3. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/PKG-INFO +34 -11
  4. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/SOURCES.txt +21 -0
  5. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/requires.txt +0 -2
  6. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/config.py +121 -17
  7. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/__init__.py +1 -1
  8. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/camera.py +122 -25
  9. ai_virtual_mouse_controller-1.4.0/core/camera_select.py +145 -0
  10. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/cursor_controller.py +50 -21
  11. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/gesture_detector.py +124 -41
  12. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/hand_anchor.py +89 -5
  13. ai_virtual_mouse_controller-1.4.0/core/hand_arbiter.py +213 -0
  14. ai_virtual_mouse_controller-1.4.0/core/hand_gate.py +126 -0
  15. ai_virtual_mouse_controller-1.4.0/core/hand_gl_renderer.py +347 -0
  16. ai_virtual_mouse_controller-1.4.0/core/hand_mesh.py +515 -0
  17. ai_virtual_mouse_controller-1.4.0/core/hand_pose.py +264 -0
  18. ai_virtual_mouse_controller-1.4.0/core/hand_soft_renderer.py +262 -0
  19. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/hand_tracker.py +54 -17
  20. ai_virtual_mouse_controller-1.4.0/core/hologram_gl_backend.py +345 -0
  21. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/hologram_overlay.py +71 -4
  22. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/perf_telemetry.py +11 -4
  23. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/presentation_controller.py +3 -2
  24. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/runtime_settings.py +24 -16
  25. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/settings_panel.py +10 -3
  26. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/smoothing.py +37 -0
  27. ai_virtual_mouse_controller-1.4.0/core/two_hands.py +200 -0
  28. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/ui_overlay.py +2 -2
  29. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/utils.py +37 -0
  30. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/main.py +78 -2
  31. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/pyproject.toml +6 -8
  32. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/services/virtual_mouse_service.py +565 -210
  33. ai_virtual_mouse_controller-1.4.0/tests/test_camera.py +118 -0
  34. ai_virtual_mouse_controller-1.4.0/tests/test_camera_select.py +113 -0
  35. ai_virtual_mouse_controller-1.4.0/tests/test_cursor_feel.py +92 -0
  36. ai_virtual_mouse_controller-1.4.0/tests/test_gesture_detector_behavior.py +200 -0
  37. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_hand_anchor_bottom.py +33 -0
  38. ai_virtual_mouse_controller-1.4.0/tests/test_hand_arbiter.py +152 -0
  39. ai_virtual_mouse_controller-1.4.0/tests/test_hand_gate.py +153 -0
  40. ai_virtual_mouse_controller-1.4.0/tests/test_hand_mesh.py +75 -0
  41. ai_virtual_mouse_controller-1.4.0/tests/test_hand_pose.py +111 -0
  42. ai_virtual_mouse_controller-1.4.0/tests/test_hand_renderers.py +98 -0
  43. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_hologram_overlay.py +3 -3
  44. ai_virtual_mouse_controller-1.4.0/tests/test_motion_quality.py +87 -0
  45. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_overlay_smoke.py +4 -2
  46. ai_virtual_mouse_controller-1.4.0/tests/test_runtime_settings.py +50 -0
  47. ai_virtual_mouse_controller-1.4.0/tests/test_service_camera_loss.py +65 -0
  48. ai_virtual_mouse_controller-1.4.0/tests/test_two_hands.py +416 -0
  49. ai_virtual_mouse_controller-1.4.0/tests/test_vision_runtime.py +300 -0
  50. ai_virtual_mouse_controller-1.2.0/core/hand_mesh.py +0 -794
  51. ai_virtual_mouse_controller-1.2.0/core/hologram_gl_backend.py +0 -964
  52. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/LICENSE +0 -0
  53. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/dependency_links.txt +0 -0
  54. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/entry_points.txt +0 -0
  55. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/top_level.txt +0 -0
  56. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/avmc.py +0 -0
  57. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/click_burst.py +0 -0
  58. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/finger_posture.py +0 -0
  59. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/hand_renderer.py +0 -0
  60. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/models/hand_landmarker.task +0 -0
  61. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/windows_path.py +0 -0
  62. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/services/__init__.py +0 -0
  63. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/setup.cfg +0 -0
  64. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_click_burst.py +0 -0
  65. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_cursor_bottom_reach.py +0 -0
  66. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_cursor_click_at.py +0 -0
  67. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_gesture_detector.py +0 -0
  68. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_hand_renderer.py +0 -0
  69. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_hand_tracker.py +0 -0
  70. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_perf_telemetry.py +0 -0
  71. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_presentation_controller.py +0 -0
  72. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_settings_panel.py +0 -0
  73. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_smoothing.py +0 -0
  74. {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_windows_path.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ai-virtual-mouse-controller
3
- Version: 1.2.0
3
+ Version: 1.4.0
4
4
  Summary: Controle de cursor por gestos da mao via webcam, com holograma 3D opcional.
5
5
  Author: Guilherme Moraes Franco
6
6
  License: MIT
@@ -32,10 +32,8 @@ Requires-Dist: opencv-contrib-python<5.0.0,>=4.10.0
32
32
  Requires-Dist: mediapipe>=0.10.18
33
33
  Requires-Dist: pyautogui<1.0.0,>=0.9.54
34
34
  Requires-Dist: numpy>=1.26.0
35
- Requires-Dist: moderngl>=5.10.0
36
35
  Requires-Dist: PySide6>=6.6.0
37
36
  Provides-Extra: hologram
38
- Requires-Dist: moderngl>=5.10.0; extra == "hologram"
39
37
  Requires-Dist: PySide6>=6.6.0; extra == "hologram"
40
38
  Provides-Extra: dev
41
39
  Requires-Dist: pytest>=8.0.0; extra == "dev"
@@ -89,7 +87,7 @@ O **AI Virtual Mouse Controller** é um mouse virtual com reconhecimento de gest
89
87
 
90
88
  100% local. Sem nuvem, sem telemetria, sem persistir nada da webcam.
91
89
 
92
- **Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy · ModernGL/PySide6 (opcional)
90
+ **Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy · PySide6 (holograma 3D via OpenGL do Qt)
93
91
 
94
92
  ---
95
93
 
@@ -118,6 +116,7 @@ Posicione a mão a ~50cm da câmera. Atalhos em runtime:
118
116
  | Tecla | Ação |
119
117
  |---|---|
120
118
  | `H` | liga/desliga o holograma 3D |
119
+ | `B` | liga/desliga o modo duas mãos |
121
120
  | `S` | abre/fecha o painel de configurações |
122
121
  | `T` | alterna janela sempre-no-topo |
123
122
  | `ESC` | sai |
@@ -191,7 +190,26 @@ Histórico de mudanças em [CHANGELOG.md](CHANGELOG.md).
191
190
  | Punho fechado | ✊ | Cursor congelado |
192
191
  | Mão fora do frame | — | Pausa automática |
193
192
 
194
- Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico.
193
+ Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico. Pra evitar clique sem querer, a pinça só começa com os outros dedos abertos: fechar a mão não clica.
194
+
195
+ ### Modo duas mãos
196
+
197
+ Aperte `B` (ou use o painel) pra usar as duas mãos: as duas aparecem no holograma e fazem os mesmos gestos. O Windows tem um cursor só, então:
198
+
199
+ - o cursor segue a mão **dona**: a primeira que apareceu ou a que se mexeu enquanto a outra estava parada;
200
+ - a outra mão clica na própria posição, e o cursor volta pra dona na hora;
201
+ - só uma mão arrasta por vez; enquanto isso, as ações da outra ficam em espera.
202
+
203
+ O modo é opcional porque detectar duas mãos custa mais processamento, e não funciona junto com o modo apresentação.
204
+
205
+ ### Escolher a câmera
206
+
207
+ ```bash
208
+ avmc --list-cameras
209
+ avmc --camera 1
210
+ ```
211
+
212
+ A câmera escolhida fica salva pras próximas vezes. Se ela não abrir, o app usa a padrão.
195
213
 
196
214
  ---
197
215
 
@@ -201,13 +219,15 @@ Toda a calibração vive em [`config.py`](config.py) — constantes nomeadas com
201
219
 
202
220
  | Seção | O que controla |
203
221
  |---|---|
204
- | `CAMERA` | índice da câmera, resolução, FPS alvo |
222
+ | `CAMERA` | índice padrão da câmera, resolução, FPS alvo (escolha sem editar: `avmc --list-cameras` e `avmc --camera N`) |
223
+ | `PROFILE` | perfil inicial do painel: `smooth`, `precise`, `responsive`, `stable` |
205
224
  | `CURSOR_ANCHOR` | qual ponto da mão o cursor segue (`-2` = âncora robusta, default) |
206
- | `PINCH` | thresholds de detecção de clique (com escala adaptativa por tamanho da mão) |
225
+ | `PINCH` | thresholds de detecção de clique (escala adaptativa por tamanho da mão + histerese pra soltar) |
207
226
  | `DPI` / `SMOOTHING` | sensibilidade do cursor + filtro OneEuro |
208
227
  | `SCREEN_MARGIN_*` | margens assimétricas (top/bottom < lateral) pra alcançar cantos |
209
228
  | `CURSOR_FOLLOWTHROUGH_*` | cinematic prediction quando a mão sai do FOV |
210
- | `HOLOGRAM` | backend (GL/QPainter), cor, opacidade, FPS |
229
+ | `HOLOGRAM` | estilo (`quest`, `graphite`, `neon`), backend (OpenGL/QPainter), tamanho, opacidade, FPS |
230
+ | `TWO_HANDS` | modo duas mãos ao iniciar e tecla de atalho |
211
231
 
212
232
  Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`) — perfis prontos: *smooth*, *precise*, *responsive*, *stable*.
213
233
 
@@ -231,6 +251,8 @@ Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`)
231
251
  ```
232
252
  webcam → MediaPipe Hands (21 landmarks)
233
253
  ↓
254
+ HandGate ← descarta mão repetida, fantasma e detecção passageira
255
+ ↓
234
256
  RobustHandAnchor ← combina anatomia + estabilidade + edge extrapolation
235
257
  ↓
236
258
  GestureDetector ← state machine: shape → event (CLICK, MOVE, DRAG…)
@@ -240,7 +262,7 @@ webcam → MediaPipe Hands (21 landmarks)
240
262
  CursorController ← PyAutoGUI move o cursor real
241
263
  ```
242
264
 
243
- Componentes auxiliares: `HologramOverlay` (renderização 3D opcional via ModernGL), `RuntimeSettings` (perfis e sliders), `PerfTelemetry` (timing p50/p99 por estágio).
265
+ Esse caminho roda em thread própria: holograma e preview ficam na thread principal e não atrasam o cursor. Componentes auxiliares: `HologramOverlay` (mão 3D estilo headset VR: `hand_pose` → `hand_mesh` → shader OpenGL do Qt, com fallback 2D QPainter), `RuntimeSettings` (perfis e sliders), `PerfTelemetry` (timing p50/p99 por estágio).
244
266
 
245
267
  Estrutura de pastas:
246
268
 
@@ -249,7 +271,8 @@ core/ # camera, hand_tracker, gesture_detector, hand_anchor, smoothing
249
271
  services/ # orquestração do loop principal
250
272
  config.py # constantes de calibração documentadas
251
273
  main.py # entry point
252
- tests/ # cobertura dos módulos puros (sem cv2/mediapipe)
274
+ scripts/ # eval_motion.py: jitter/atraso/cliques; eval_latency.py: câmera -> cursor
275
+ tests/ # unitários + gate de qualidade de movimento
253
276
  docs/ # site estático + assets
254
277
  ```
255
278
 
@@ -269,7 +292,7 @@ make test-gpu # só testes que precisam de display/GPU real
269
292
  make test-cov # com coverage HTML
270
293
  ```
271
294
 
272
- Testes marcados com `gpu` (overlay PySide6/ModernGL) ficam fora do `pytest` default — eles requerem display real e podem crashar em ambientes headless. Rode-os explicitamente com `make test-gpu` quando estiver mexendo no holograma.
295
+ Testes marcados com `gpu` (overlay PySide6/OpenGL) ficam fora do `pytest` default — eles requerem display real e podem crashar em ambientes headless. Rode-os explicitamente com `make test-gpu` quando estiver mexendo no holograma.
273
296
 
274
297
  ---
275
298
 
@@ -42,7 +42,7 @@ O **AI Virtual Mouse Controller** é um mouse virtual com reconhecimento de gest
42
42
 
43
43
  100% local. Sem nuvem, sem telemetria, sem persistir nada da webcam.
44
44
 
45
- **Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy · ModernGL/PySide6 (opcional)
45
+ **Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy · PySide6 (holograma 3D via OpenGL do Qt)
46
46
 
47
47
  ---
48
48
 
@@ -71,6 +71,7 @@ Posicione a mão a ~50cm da câmera. Atalhos em runtime:
71
71
  | Tecla | Ação |
72
72
  |---|---|
73
73
  | `H` | liga/desliga o holograma 3D |
74
+ | `B` | liga/desliga o modo duas mãos |
74
75
  | `S` | abre/fecha o painel de configurações |
75
76
  | `T` | alterna janela sempre-no-topo |
76
77
  | `ESC` | sai |
@@ -144,7 +145,26 @@ Histórico de mudanças em [CHANGELOG.md](CHANGELOG.md).
144
145
  | Punho fechado | ✊ | Cursor congelado |
145
146
  | Mão fora do frame | — | Pausa automática |
146
147
 
147
- Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico.
148
+ Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico. Pra evitar clique sem querer, a pinça só começa com os outros dedos abertos: fechar a mão não clica.
149
+
150
+ ### Modo duas mãos
151
+
152
+ Aperte `B` (ou use o painel) pra usar as duas mãos: as duas aparecem no holograma e fazem os mesmos gestos. O Windows tem um cursor só, então:
153
+
154
+ - o cursor segue a mão **dona**: a primeira que apareceu ou a que se mexeu enquanto a outra estava parada;
155
+ - a outra mão clica na própria posição, e o cursor volta pra dona na hora;
156
+ - só uma mão arrasta por vez; enquanto isso, as ações da outra ficam em espera.
157
+
158
+ O modo é opcional porque detectar duas mãos custa mais processamento, e não funciona junto com o modo apresentação.
159
+
160
+ ### Escolher a câmera
161
+
162
+ ```bash
163
+ avmc --list-cameras
164
+ avmc --camera 1
165
+ ```
166
+
167
+ A câmera escolhida fica salva pras próximas vezes. Se ela não abrir, o app usa a padrão.
148
168
 
149
169
  ---
150
170
 
@@ -154,13 +174,15 @@ Toda a calibração vive em [`config.py`](config.py) — constantes nomeadas com
154
174
 
155
175
  | Seção | O que controla |
156
176
  |---|---|
157
- | `CAMERA` | índice da câmera, resolução, FPS alvo |
177
+ | `CAMERA` | índice padrão da câmera, resolução, FPS alvo (escolha sem editar: `avmc --list-cameras` e `avmc --camera N`) |
178
+ | `PROFILE` | perfil inicial do painel: `smooth`, `precise`, `responsive`, `stable` |
158
179
  | `CURSOR_ANCHOR` | qual ponto da mão o cursor segue (`-2` = âncora robusta, default) |
159
- | `PINCH` | thresholds de detecção de clique (com escala adaptativa por tamanho da mão) |
180
+ | `PINCH` | thresholds de detecção de clique (escala adaptativa por tamanho da mão + histerese pra soltar) |
160
181
  | `DPI` / `SMOOTHING` | sensibilidade do cursor + filtro OneEuro |
161
182
  | `SCREEN_MARGIN_*` | margens assimétricas (top/bottom < lateral) pra alcançar cantos |
162
183
  | `CURSOR_FOLLOWTHROUGH_*` | cinematic prediction quando a mão sai do FOV |
163
- | `HOLOGRAM` | backend (GL/QPainter), cor, opacidade, FPS |
184
+ | `HOLOGRAM` | estilo (`quest`, `graphite`, `neon`), backend (OpenGL/QPainter), tamanho, opacidade, FPS |
185
+ | `TWO_HANDS` | modo duas mãos ao iniciar e tecla de atalho |
164
186
 
165
187
  Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`) — perfis prontos: *smooth*, *precise*, *responsive*, *stable*.
166
188
 
@@ -184,6 +206,8 @@ Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`)
184
206
  ```
185
207
  webcam → MediaPipe Hands (21 landmarks)
186
208
  ↓
209
+ HandGate ← descarta mão repetida, fantasma e detecção passageira
210
+ ↓
187
211
  RobustHandAnchor ← combina anatomia + estabilidade + edge extrapolation
188
212
  ↓
189
213
  GestureDetector ← state machine: shape → event (CLICK, MOVE, DRAG…)
@@ -193,7 +217,7 @@ webcam → MediaPipe Hands (21 landmarks)
193
217
  CursorController ← PyAutoGUI move o cursor real
194
218
  ```
195
219
 
196
- Componentes auxiliares: `HologramOverlay` (renderização 3D opcional via ModernGL), `RuntimeSettings` (perfis e sliders), `PerfTelemetry` (timing p50/p99 por estágio).
220
+ Esse caminho roda em thread própria: holograma e preview ficam na thread principal e não atrasam o cursor. Componentes auxiliares: `HologramOverlay` (mão 3D estilo headset VR: `hand_pose` → `hand_mesh` → shader OpenGL do Qt, com fallback 2D QPainter), `RuntimeSettings` (perfis e sliders), `PerfTelemetry` (timing p50/p99 por estágio).
197
221
 
198
222
  Estrutura de pastas:
199
223
 
@@ -202,7 +226,8 @@ core/ # camera, hand_tracker, gesture_detector, hand_anchor, smoothing
202
226
  services/ # orquestração do loop principal
203
227
  config.py # constantes de calibração documentadas
204
228
  main.py # entry point
205
- tests/ # cobertura dos módulos puros (sem cv2/mediapipe)
229
+ scripts/ # eval_motion.py: jitter/atraso/cliques; eval_latency.py: câmera -> cursor
230
+ tests/ # unitários + gate de qualidade de movimento
206
231
  docs/ # site estático + assets
207
232
  ```
208
233
 
@@ -222,7 +247,7 @@ make test-gpu # só testes que precisam de display/GPU real
222
247
  make test-cov # com coverage HTML
223
248
  ```
224
249
 
225
- Testes marcados com `gpu` (overlay PySide6/ModernGL) ficam fora do `pytest` default — eles requerem display real e podem crashar em ambientes headless. Rode-os explicitamente com `make test-gpu` quando estiver mexendo no holograma.
250
+ Testes marcados com `gpu` (overlay PySide6/OpenGL) ficam fora do `pytest` default — eles requerem display real e podem crashar em ambientes headless. Rode-os explicitamente com `make test-gpu` quando estiver mexendo no holograma.
226
251
 
227
252
  ---
228
253
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ai-virtual-mouse-controller
3
- Version: 1.2.0
3
+ Version: 1.4.0
4
4
  Summary: Controle de cursor por gestos da mao via webcam, com holograma 3D opcional.
5
5
  Author: Guilherme Moraes Franco
6
6
  License: MIT
@@ -32,10 +32,8 @@ Requires-Dist: opencv-contrib-python<5.0.0,>=4.10.0
32
32
  Requires-Dist: mediapipe>=0.10.18
33
33
  Requires-Dist: pyautogui<1.0.0,>=0.9.54
34
34
  Requires-Dist: numpy>=1.26.0
35
- Requires-Dist: moderngl>=5.10.0
36
35
  Requires-Dist: PySide6>=6.6.0
37
36
  Provides-Extra: hologram
38
- Requires-Dist: moderngl>=5.10.0; extra == "hologram"
39
37
  Requires-Dist: PySide6>=6.6.0; extra == "hologram"
40
38
  Provides-Extra: dev
41
39
  Requires-Dist: pytest>=8.0.0; extra == "dev"
@@ -89,7 +87,7 @@ O **AI Virtual Mouse Controller** é um mouse virtual com reconhecimento de gest
89
87
 
90
88
  100% local. Sem nuvem, sem telemetria, sem persistir nada da webcam.
91
89
 
92
- **Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy · ModernGL/PySide6 (opcional)
90
+ **Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy · PySide6 (holograma 3D via OpenGL do Qt)
93
91
 
94
92
  ---
95
93
 
@@ -118,6 +116,7 @@ Posicione a mão a ~50cm da câmera. Atalhos em runtime:
118
116
  | Tecla | Ação |
119
117
  |---|---|
120
118
  | `H` | liga/desliga o holograma 3D |
119
+ | `B` | liga/desliga o modo duas mãos |
121
120
  | `S` | abre/fecha o painel de configurações |
122
121
  | `T` | alterna janela sempre-no-topo |
123
122
  | `ESC` | sai |
@@ -191,7 +190,26 @@ Histórico de mudanças em [CHANGELOG.md](CHANGELOG.md).
191
190
  | Punho fechado | ✊ | Cursor congelado |
192
191
  | Mão fora do frame | — | Pausa automática |
193
192
 
194
- Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico.
193
+ Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico. Pra evitar clique sem querer, a pinça só começa com os outros dedos abertos: fechar a mão não clica.
194
+
195
+ ### Modo duas mãos
196
+
197
+ Aperte `B` (ou use o painel) pra usar as duas mãos: as duas aparecem no holograma e fazem os mesmos gestos. O Windows tem um cursor só, então:
198
+
199
+ - o cursor segue a mão **dona**: a primeira que apareceu ou a que se mexeu enquanto a outra estava parada;
200
+ - a outra mão clica na própria posição, e o cursor volta pra dona na hora;
201
+ - só uma mão arrasta por vez; enquanto isso, as ações da outra ficam em espera.
202
+
203
+ O modo é opcional porque detectar duas mãos custa mais processamento, e não funciona junto com o modo apresentação.
204
+
205
+ ### Escolher a câmera
206
+
207
+ ```bash
208
+ avmc --list-cameras
209
+ avmc --camera 1
210
+ ```
211
+
212
+ A câmera escolhida fica salva pras próximas vezes. Se ela não abrir, o app usa a padrão.
195
213
 
196
214
  ---
197
215
 
@@ -201,13 +219,15 @@ Toda a calibração vive em [`config.py`](config.py) — constantes nomeadas com
201
219
 
202
220
  | Seção | O que controla |
203
221
  |---|---|
204
- | `CAMERA` | índice da câmera, resolução, FPS alvo |
222
+ | `CAMERA` | índice padrão da câmera, resolução, FPS alvo (escolha sem editar: `avmc --list-cameras` e `avmc --camera N`) |
223
+ | `PROFILE` | perfil inicial do painel: `smooth`, `precise`, `responsive`, `stable` |
205
224
  | `CURSOR_ANCHOR` | qual ponto da mão o cursor segue (`-2` = âncora robusta, default) |
206
- | `PINCH` | thresholds de detecção de clique (com escala adaptativa por tamanho da mão) |
225
+ | `PINCH` | thresholds de detecção de clique (escala adaptativa por tamanho da mão + histerese pra soltar) |
207
226
  | `DPI` / `SMOOTHING` | sensibilidade do cursor + filtro OneEuro |
208
227
  | `SCREEN_MARGIN_*` | margens assimétricas (top/bottom < lateral) pra alcançar cantos |
209
228
  | `CURSOR_FOLLOWTHROUGH_*` | cinematic prediction quando a mão sai do FOV |
210
- | `HOLOGRAM` | backend (GL/QPainter), cor, opacidade, FPS |
229
+ | `HOLOGRAM` | estilo (`quest`, `graphite`, `neon`), backend (OpenGL/QPainter), tamanho, opacidade, FPS |
230
+ | `TWO_HANDS` | modo duas mãos ao iniciar e tecla de atalho |
211
231
 
212
232
  Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`) — perfis prontos: *smooth*, *precise*, *responsive*, *stable*.
213
233
 
@@ -231,6 +251,8 @@ Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`)
231
251
  ```
232
252
  webcam → MediaPipe Hands (21 landmarks)
233
253
  ↓
254
+ HandGate ← descarta mão repetida, fantasma e detecção passageira
255
+ ↓
234
256
  RobustHandAnchor ← combina anatomia + estabilidade + edge extrapolation
235
257
  ↓
236
258
  GestureDetector ← state machine: shape → event (CLICK, MOVE, DRAG…)
@@ -240,7 +262,7 @@ webcam → MediaPipe Hands (21 landmarks)
240
262
  CursorController ← PyAutoGUI move o cursor real
241
263
  ```
242
264
 
243
- Componentes auxiliares: `HologramOverlay` (renderização 3D opcional via ModernGL), `RuntimeSettings` (perfis e sliders), `PerfTelemetry` (timing p50/p99 por estágio).
265
+ Esse caminho roda em thread própria: holograma e preview ficam na thread principal e não atrasam o cursor. Componentes auxiliares: `HologramOverlay` (mão 3D estilo headset VR: `hand_pose` → `hand_mesh` → shader OpenGL do Qt, com fallback 2D QPainter), `RuntimeSettings` (perfis e sliders), `PerfTelemetry` (timing p50/p99 por estágio).
244
266
 
245
267
  Estrutura de pastas:
246
268
 
@@ -249,7 +271,8 @@ core/ # camera, hand_tracker, gesture_detector, hand_anchor, smoothing
249
271
  services/ # orquestração do loop principal
250
272
  config.py # constantes de calibração documentadas
251
273
  main.py # entry point
252
- tests/ # cobertura dos módulos puros (sem cv2/mediapipe)
274
+ scripts/ # eval_motion.py: jitter/atraso/cliques; eval_latency.py: câmera -> cursor
275
+ tests/ # unitários + gate de qualidade de movimento
253
276
  docs/ # site estático + assets
254
277
  ```
255
278
 
@@ -269,7 +292,7 @@ make test-gpu # só testes que precisam de display/GPU real
269
292
  make test-cov # com coverage HTML
270
293
  ```
271
294
 
272
- Testes marcados com `gpu` (overlay PySide6/ModernGL) ficam fora do `pytest` default — eles requerem display real e podem crashar em ambientes headless. Rode-os explicitamente com `make test-gpu` quando estiver mexendo no holograma.
295
+ Testes marcados com `gpu` (overlay PySide6/OpenGL) ficam fora do `pytest` default — eles requerem display real e podem crashar em ambientes headless. Rode-os explicitamente com `make test-gpu` quando estiver mexendo no holograma.
273
296
 
274
297
  ---
275
298
 
@@ -12,13 +12,19 @@ ai_virtual_mouse_controller.egg-info/requires.txt
12
12
  ai_virtual_mouse_controller.egg-info/top_level.txt
13
13
  core/__init__.py
14
14
  core/camera.py
15
+ core/camera_select.py
15
16
  core/click_burst.py
16
17
  core/cursor_controller.py
17
18
  core/finger_posture.py
18
19
  core/gesture_detector.py
19
20
  core/hand_anchor.py
21
+ core/hand_arbiter.py
22
+ core/hand_gate.py
23
+ core/hand_gl_renderer.py
20
24
  core/hand_mesh.py
25
+ core/hand_pose.py
21
26
  core/hand_renderer.py
27
+ core/hand_soft_renderer.py
22
28
  core/hand_tracker.py
23
29
  core/hologram_gl_backend.py
24
30
  core/hologram_overlay.py
@@ -27,23 +33,38 @@ core/presentation_controller.py
27
33
  core/runtime_settings.py
28
34
  core/settings_panel.py
29
35
  core/smoothing.py
36
+ core/two_hands.py
30
37
  core/ui_overlay.py
31
38
  core/utils.py
32
39
  core/windows_path.py
33
40
  core/models/hand_landmarker.task
34
41
  services/__init__.py
35
42
  services/virtual_mouse_service.py
43
+ tests/test_camera.py
44
+ tests/test_camera_select.py
36
45
  tests/test_click_burst.py
37
46
  tests/test_cursor_bottom_reach.py
38
47
  tests/test_cursor_click_at.py
48
+ tests/test_cursor_feel.py
39
49
  tests/test_gesture_detector.py
50
+ tests/test_gesture_detector_behavior.py
40
51
  tests/test_hand_anchor_bottom.py
52
+ tests/test_hand_arbiter.py
53
+ tests/test_hand_gate.py
54
+ tests/test_hand_mesh.py
55
+ tests/test_hand_pose.py
41
56
  tests/test_hand_renderer.py
57
+ tests/test_hand_renderers.py
42
58
  tests/test_hand_tracker.py
43
59
  tests/test_hologram_overlay.py
60
+ tests/test_motion_quality.py
44
61
  tests/test_overlay_smoke.py
45
62
  tests/test_perf_telemetry.py
46
63
  tests/test_presentation_controller.py
64
+ tests/test_runtime_settings.py
65
+ tests/test_service_camera_loss.py
47
66
  tests/test_settings_panel.py
48
67
  tests/test_smoothing.py
68
+ tests/test_two_hands.py
69
+ tests/test_vision_runtime.py
49
70
  tests/test_windows_path.py
@@ -2,7 +2,6 @@ opencv-contrib-python<5.0.0,>=4.10.0
2
2
  mediapipe>=0.10.18
3
3
  pyautogui<1.0.0,>=0.9.54
4
4
  numpy>=1.26.0
5
- moderngl>=5.10.0
6
5
  PySide6>=6.6.0
7
6
 
8
7
  [dev]
@@ -13,5 +12,4 @@ mypy>=1.10.0
13
12
  pre-commit>=3.7.0
14
13
 
15
14
  [hologram]
16
- moderngl>=5.10.0
17
15
  PySide6>=6.6.0
@@ -30,6 +30,7 @@ CAMERA_FPS_TARGET: int = 60
30
30
  # ---------------------------------------------------------------------
31
31
 
32
32
  MAX_NUM_HANDS: int = 1
33
+ """Maos detectadas fora do modo duas maos (ver TWO_HANDS_ENABLED)."""
33
34
  MIN_DETECTION_CONFIDENCE: float = 0.6
34
35
  MIN_TRACKING_CONFIDENCE: float = 0.4
35
36
  MODEL_COMPLEXITY: int = 0
@@ -39,6 +40,27 @@ O HandLandmarker tem um unico modelo (equivalente ao antigo 1=full).
39
40
  Mantido so pra nao quebrar configs existentes.
40
41
  """
41
42
 
43
+ VISION_THREAD_ENABLED: bool = True
44
+ """Roda camera -> MediaPipe -> gestos -> cursor em thread propria.
45
+
46
+ Preview e holograma nao atrasam mais o cursor: sem isso, com o holograma
47
+ ligado, o loop caia de 29 para 16 quadros por segundo e metade dos cliques do
48
+ video de teste se perdia (ver scripts/eval_latency.py)."""
49
+
50
+ POWER_THROTTLING_OFF: bool = True
51
+ """Windows: tira este processo da economia de energia. Sem foco, ele ia pros
52
+ nucleos economicos e a inferencia ficava mais lenta."""
53
+
54
+ OPENCV_SINGLE_THREAD: bool = True
55
+ """OpenCV com 1 thread: nao disputa nucleo com o MediaPipe. O que ele faz aqui
56
+ (converter cor, desenhar o preview) nao precisa de mais."""
57
+
58
+ PREVIEW_MAX_FPS: float = 30.0
59
+ """Limite do preview da camera. O cursor nao depende dele. 0 = sem limite."""
60
+
61
+ HAND_CONFIRM_FRAMES: int = 2
62
+ """Frames seguidos que uma mao nova precisa aparecer antes de agir."""
63
+
42
64
  INFERENCE_PRE_RESIZE_ENABLED: bool = False
43
65
  """Redimensiona o frame BGR antes de enviar pro MediaPipe.
44
66
 
@@ -146,6 +168,17 @@ DPI_MULTIPLIER_MIN: float = 0.7
146
168
  DPI_MULTIPLIER_MAX: float = 1.4
147
169
  DPI_FIXED_MULTIPLIER: float = 1.00
148
170
 
171
+ DPI_SIZE_SMOOTHING_S: float = 0.6
172
+ """Constante de tempo (s) do tamanho da mao usado no DPI adaptativo.
173
+
174
+ O tamanho da mao no frame estima a DISTANCIA ate a camera — algo que muda
175
+ devagar. Frame a frame ele oscila quando o pulso inclina/gira e com o
176
+ ruido do tracker; como o DPI escala a posicao a partir do centro da tela,
177
+ isso fazia o cursor andar sozinho com a mao parada (ate ~50 px longe do
178
+ centro). 0.6 s filtra a inclinacao e ainda acompanha quem aproxima ou
179
+ afasta a mao da camera. 0 = comportamento antigo (cru).
180
+ """
181
+
149
182
  # ---------------------------------------------------------------------
150
183
  # SUAVIZACAO
151
184
  # ---------------------------------------------------------------------
@@ -155,9 +188,18 @@ SMOOTHING_STRATEGY: SmoothingStrategy = "one_euro"
155
188
 
156
189
  SMOOTHING_FACTOR: float = 0.6
157
190
 
191
+ PROFILE: str = "smooth"
192
+ """Perfil inicial do painel: 'smooth', 'precise', 'responsive' ou
193
+ 'stable'. Define suavizacao, sensibilidade, pinca, aim assist, sticky e a
194
+ trava no clique (ver core/runtime_settings.PROFILES)."""
195
+
158
196
  ONE_EURO_FREQ: float = 60.0
197
+ # min_cutoff e beta efetivos vem do PERFIL (painel, slider Suavizacao) —
198
+ # os dois abaixo ficam como referencia do perfil 'recommended'.
199
+ # beta esta na escala das coordenadas normalizadas (0-1): valores ~0.02
200
+ # deixavam o filtro sem adaptacao e o cursor arrastando atras da mao.
159
201
  ONE_EURO_MIN_CUTOFF: float = 1.2
160
- ONE_EURO_BETA: float = 0.020
202
+ ONE_EURO_BETA: float = 5.7
161
203
  ONE_EURO_D_CUTOFF: float = 1.0
162
204
  DEAD_ZONE_PIXELS: int = 1
163
205
 
@@ -192,9 +234,33 @@ vem do debounce de 2 frames + threshold.
192
234
 
193
235
  PINCH_VELOCITY_THRESHOLD: float = 0.008
194
236
 
237
+ PINCH_OPEN_FINGERS_MIN: float = 0.82
238
+ """Pra COMECAR uma pinca, os outros dedos precisam estar abertos (extensao
239
+ media; 1 = retos). Fechar a mao aproxima o polegar do indicador, e isso virava
240
+ clique. Em uso real: pinca >= 0.87, dedos fechados <= 0.79. Quem pinca com os
241
+ outros dedos bem dobrados pode abaixar; 0 desliga. Quem ja segura a pinca nao
242
+ e' afetado."""
243
+
244
+ PINCH_REARM_SECONDS: float = 0.12
245
+ """Tempo minimo com os dedos abertos antes de outra pinca valer como clique.
246
+ Evita rajada quando a pinca oscila (mao na frente do rosto, por exemplo)."""
247
+
248
+ PINCH_RELEASE_RATIO: float = 1.25
249
+ """Histerese da pinca (Schmitt trigger): pra SOLTAR a pinca, polegar e
250
+ indicador precisam abrir ate threshold * 1.25 (entrar continua em
251
+ threshold). Vale tambem pro clique direito.
252
+
253
+ Com limiar unico, o ruido do tracker com os dedos perto da borda fazia a
254
+ pinca "piscar": clique extra no encostar seguinte ou drag caindo sozinho.
255
+ Mesma tecnica dos detectores de pinca da Ultraleap (distancias separadas
256
+ de ativar/desativar). 1.0 = comportamento antigo (limiar unico).
257
+ Suba (1.35) se ainda notar clique duplo acidental; desca (1.15) se soltar
258
+ o drag ficar dificil.
259
+ """
260
+
195
261
  PINCH_MIN_HOLD_SECONDS: float = 0.015
196
- """Tempo minimo da pinca pra contar como click. 15ms permite cliques
197
- rapidos e fluidos sem disparar em encontros acidentais."""
262
+ """Sem efeito no modelo press-to-click (o clique sai no encostar).
263
+ Mantido so pra nao quebrar configs existentes."""
198
264
 
199
265
  # ---------------------------------------------------------------------
200
266
  # CLIQUE DIREITO — pinca polegar+medio
@@ -416,6 +482,13 @@ alvos pequenos errarem.
416
482
  0.12s cobre o intervalo entre a deteccao do raw shape PINCH e a
417
483
  estabilizacao da pose. Aumente pra 0.15-0.20s se ainda notar deriva.
418
484
  Diminua pra 0.08s se sentir cursor "preso" apos clicks consecutivos.
485
+
486
+ Em runtime o valor vem do PERFIL (slider "Trava no clique" do painel);
487
+ este e' o valor de referencia do perfil 'smooth'/'recommended'.
488
+
489
+ Ao destravar, o cursor NAO salta pra onde a mao foi durante a trava: a
490
+ diferenca e' absorvida aos poucos conforme a mao se move (ver
491
+ CursorController._reconcile_offset). Vale tambem pro fim do drag.
419
492
  """
420
493
 
421
494
  DRAG_PRECISION_FACTOR: float = 0.55
@@ -459,7 +532,7 @@ SHOW_DPI: bool = True
459
532
  SHOW_DRAG_PROGRESS: bool = True
460
533
  SHOW_AIM_ASSIST: bool = True
461
534
  DRAW_LANDMARKS: bool = True
462
- WINDOW_NAME: str = "AI Virtual Mouse — ESC to quit"
535
+ WINDOW_NAME: str = "AI Virtual Mouse - ESC to quit"
463
536
 
464
537
  # ---------------------------------------------------------------------
465
538
  # JANELA DE EXIBICAO
@@ -511,28 +584,46 @@ parece magica; em uso prolongado pode distrair.
511
584
  HOLOGRAM_BACKEND: str = "auto"
512
585
  """Backend de renderizacao do holograma.
513
586
 
514
- - "auto" : tenta GL primeiro; cai pra QPainter se driver falhar
515
- - "gl" : forca ModernGL (mesh 3D + GLSL shader)
516
- - "qpainter" : forca pipeline 2D vetorial (compatibilidade/debug)
587
+ - "auto" : OpenGL 3D se houver OpenGL 3.3 (testado na inicializacao);
588
+ senao cai pro renderer 2D QPainter no mesmo estilo
589
+ - "gl" : forca OpenGL (mesh 3D + shader)
590
+ - "qpainter" : forca o renderer 2D (compatibilidade/debug)
591
+
592
+ O OpenGL e' o do proprio Qt (PySide6) — nao depende de moderngl/
593
+ glcontext, cuja DLL o Smart App Control do Windows pode bloquear.
594
+ Em ambientes sem GPU/driver (RDP, VM sem aceleracao) o "auto" ja cai
595
+ pro QPainter sozinho.
596
+ """
597
+
598
+ HOLOGRAM_STYLE: str = "quest"
599
+ """Aparencia da mao.
600
+
601
+ - "quest" : mao 3D estilo headset VR — azul-acinzentado claro, luz
602
+ suave, borda luminosa, antebraco em fade, pontas brilham
603
+ na pinca (default)
604
+ - "graphite" : mesma mao, grafite translucido com contorno claro (fundos
605
+ claros)
606
+ - "neon" : visual antigo (silhueta neon + particulas, so 2D)
517
607
 
518
- ModernGL renderiza a mao como mesh 3D real (palm ellipsoide + finger
519
- capsules) com shader holografico (fresnel rim, depth fade, cyan
520
- volumetric). Requer driver OpenGL 3.3+. Em ambientes sem GPU/driver
521
- (RDP, VM sem aceleracao), usar "qpainter".
608
+ Nos estilos 3D a mao segue a pose real: aspecto correto da camera,
609
+ profundidade de cada articulacao e escala estavel pela palma (fechar a
610
+ mao nao a "infla"). Ver core/hand_pose.py.
522
611
  """
523
612
 
524
613
  HOLOGRAM_TOGGLE_KEY: str = "h"
525
614
  """Tecla pra alternar o holograma em runtime."""
526
615
 
527
- HOLOGRAM_OPACITY: float = 0.70
528
- """Opacidade base. Camadas (palm/finger outline, particles, tips) usam
529
- fracoes desse valor."""
616
+ HOLOGRAM_OPACITY: float = 0.90
617
+ """Opacidade da mao. No estilo "quest" o corpo fica ~72% opaco (borda
618
+ mais forte); no "neon" as camadas usam fracoes deste valor."""
530
619
 
531
620
  HOLOGRAM_HAND_SIZE_PX: int = 180
532
- """Tamanho do bounding box da mao em pixels."""
621
+ """Tamanho da mao na tela (px): comprimento da mao aberta, do pulso a
622
+ ponta do dedo medio. Nao muda com o gesto."""
533
623
 
534
- HOLOGRAM_FPS: int = 30
535
- """Taxa de redesenho. 30 Hz e' suave + economico em CPU."""
624
+ HOLOGRAM_FPS: int = 60
625
+ """Limite de desenhos por segundo. A mao e' desenhada quando chega pose nova,
626
+ entao na pratica segue a camera; parada, nao gasta nada."""
536
627
 
537
628
  HOLOGRAM_COLOR_BONE: str = "#00d4ff"
538
629
  """Cor primaria do holograma — azul neon ciano (linhas/contornos)."""
@@ -574,6 +665,19 @@ PERF_TELEMETRY_WINDOW: int = 120
574
665
  PERF_TELEMETRY_REPORT_EVERY: int = 120
575
666
  """Logar report a cada N ticks (= 2s a 60 FPS)."""
576
667
 
668
+ # ---------------------------------------------------------------------
669
+ # MODO DUAS MAOS
670
+ # ---------------------------------------------------------------------
671
+ # As duas maos aparecem no holograma e executam os mesmos gestos. O sistema
672
+ # tem um cursor so: ele segue a mao dona, a outra clica no proprio ponteiro
673
+ # e so uma arrasta por vez (ver core/two_hands.py). Toggle via tecla B ou
674
+ # painel S; exclusivo com o modo apresentacao. Desligado nao custa nada.
675
+
676
+ TWO_HANDS_ENABLED: bool = False
677
+ """Comeca com o modo ligado."""
678
+
679
+ TWO_HANDS_TOGGLE_KEY: str = "b"
680
+
577
681
  # ---------------------------------------------------------------------
578
682
  # MODO APRESENTACAO
579
683
  # ---------------------------------------------------------------------
@@ -10,5 +10,5 @@ Versao do pacote vive em `__version__` e e' a fonte unica de verdade
10
10
 
11
11
  from __future__ import annotations
12
12
 
13
- __version__ = "1.2.0"
13
+ __version__ = "1.4.0"
14
14
  __all__ = ["__version__"]