rmayola/zonza
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Dictée vocale 100% locale pour macOS (MLX-Whisper + cercle pulsant)
28 Commits 1 Branch 0 Tags 373 KiB
Python 92.2%
Shell 4.6%
PowerShell 1.6%
C 1.6%
2ccb614649
Go to file
Ralph Mayola 2ccb614649 A chaque moteur son modele, et un forcage manuel 
app.py passait CONFIG["model"] — un depot MLX — quel que soit le moteur detecte.
Sur une machine sans Apple Silicon, faster-whisper aurait recu un depot qu'il ne
sait pas charger. Le defaut etait invisible ici, la detection rendant toujours
"mlx" sur ce Mac : aucun test ne pouvait le voir.

MODELES_PAR_MOTEUR associe chaque moteur a son depot. Les valeurs viennent de la
mesure du jour (trois echantillons, amorce active, CPU Apple Silicon) :

  faster-whisper base   0,52 s  10/13 termes techniques   142 Mo
  faster-whisper small  1,42 s  11/13                     464 Mo
  faster-whisper medium 4,40 s  13/13                    1460 Mo
  MLX medium (GPU)      0,75 s  11/13                     489 Mo

Le GPU vise donc la precision (medium, 13/13, il absorbe le cout) ; le CPU vise
la latence (small, 11/13 — AUTANT que le MLX utilise aujourd'hui — pour 1,4 s).
`medium` sur CPU serait plus juste, mais ces 4,4 s sont celles d'un CPU Apple
Silicon : sur un CPU Intel ou Windows, le meme modele peut demander trois a quatre
fois plus. La commande de diagnostic mesurera la machine reelle et pourra
promouvoir `medium`.

CONFIG["model"] passe a None et devient un FORCAGE manuel qui prime sur la table,
au lieu d'un reglage mort qu'on modifie sans effet.

115 tests. Comportement inchange sur ce Mac : moteur mlx, modele identique.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-23 18:45:14 +02:00
assets Zonza : dictée vocale locale macOS (MLX-Whisper + cercle pulsant) 2026-06-12 23:57:59 +02:00
docs/superpowers Plan : corriger deux defauts releves a l'auto-relecture 2026-08-23 17:44:39 +02:00
interface Un module plat par plateforme, pour les trois frontieres 2026-08-23 18:33:35 +02:00
launcher fix: icône barre de menu sur Tahoe — stub libpython + abandon de rumps 2026-06-13 00:54:44 +02:00
moteur Ajoute le moteur faster-whisper, pour les machines sans Apple Silicon 2026-08-23 18:38:09 +02:00
systeme Extrait les appels macOS derriere le contrat Systeme 2026-08-23 17:57:52 +02:00
tests A chaque moteur son modele, et un forcage manuel 2026-08-23 18:45:14 +02:00
.gitignore Zonza : dictée vocale locale macOS (MLX-Whisper + cercle pulsant) 2026-06-12 23:57:59 +02:00
app.py A chaque moteur son modele, et un forcage manuel 2026-08-23 18:45:14 +02:00
audio_level.py L'overlay devient une barre de dictee au lieu d'un cercle 2026-08-21 00:46:56 +02:00
build_app.sh fix: icône barre de menu sur Tahoe — stub libpython + abandon de rumps 2026-06-13 00:54:44 +02:00
capture.py Le controleur passe par les contrats, la duplication disparait 2026-08-23 18:19:25 +02:00
conftest.py Zonza : dictée vocale locale macOS (MLX-Whisper + cercle pulsant) 2026-06-12 23:57:59 +02:00
contrats.py Renforce les contrats : types complets et docstrings de methode protegees 2026-08-23 17:53:12 +02:00
controller.py Le menu Sons refonctionne, et le transcripteur porte son nom francais 2026-08-23 18:25:08 +02:00
core.py A chaque moteur son modele, et un forcage manuel 2026-08-23 18:45:14 +02:00
LICENSE Zonza : dictée vocale locale macOS (MLX-Whisper + cercle pulsant) 2026-06-12 23:57:59 +02:00
README.md Zonza : dictée vocale locale macOS (MLX-Whisper + cercle pulsant) 2026-06-12 23:57:59 +02:00
requirements.txt Ajoute le moteur faster-whisper, pour les machines sans Apple Silicon 2026-08-23 18:38:09 +02:00

README.md

Zonza 🎙️

Dictée vocale 100% locale pour macOS (Apple Silicon). Appuie sur un raccourci, un cercle pulse au rythme de ta voix, et ton texte est transcrit puis collé dans l'app active. Inspiré de Superwhisper — open source, hors-ligne, rien ne quitte ta machine.

  • Transcription locale : MLX-Whisper medium (français), aucun envoi réseau.
  • Cercle pulsant : une fenêtre flottante visualise tes intonations en temps réel.
  • Barre de menu : l'app vit dans la barre de menu macOS (jamais dans le Dock).
  • Toggle Cmd+Ctrl+D : démarre / arrête la dictée.

Installation

git clone ssh://git@git.mrtechlab.cloud:2222/rmayola/zonza.git
cd zonza
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
./build_app.sh        # installe /Applications/Zonza.app (lanceur lié à ce dépôt)

Zonza.app est un lanceur léger : il exécute le code via le venv du dépôt (MLX y tourne nativement, là où py2app/PyInstaller échouent sur les shaders Metal). Ne supprime donc ni le dossier du dépôt ni .venv. C'est aussi l'unique chemin de build — on ne construit jamais dans /tmp ni dans le dépôt, pour ne laisser aucune entrée fantôme dans LaunchServices (cause historique d'icônes en double).

Au tout premier lancement, l'app télécharge le modèle Whisper (~512 Mo, une seule fois).

Permissions macOS

Réglages Système → Confidentialité et sécurité :

  • Microphone — popup automatique au 1er enregistrement.
  • Surveillance de l'entrée / Accessibilité — pour la hotkey globale et le collage (Cmd+V simulé). Si non accordée, le texte reste dans le presse-papier : fais Cmd+V à la main.

Usage

  • L'icône 🎙️ apparaît dans la barre de menu (🔴 enregistrement, ⏳ transcription).
  • Cmd+Ctrl+D : le cercle apparaît, parle.
  • Cmd+Ctrl+D : transcription + collage dans l'app active.
  • Menu : activer/désactiver les sons, quitter.
  • Sécurité : arrêt automatique après 2 minutes d'enregistrement.

Lancer depuis les sources (développement)

source .venv/bin/activate
python3 app.py

Configuration

Édite CONFIG dans core.py : model, language, hotkey, sounds, min_duration_s, max_duration_s, fps, circle_base_radius, circle_amplitude, circle_color_rgb, level_gain, level_attack, level_release, wave_rings, wave_speed.

Tests

.venv/bin/python -m pytest tests/ -v

Architecture

  • core.py — config + utilitaires purs (seuil durée, nettoyage texte).
  • audio_level.py — niveau RMS du micro (alimente l'animation).
  • engine.py — capture, transcription MLX-Whisper, collage, sons.
  • pulse_window.py — fenêtre Cocoa + cercle pulsant + anneaux d'onde.
  • controller.py — machine à états, branche audio → animation → transcription.
  • app.py — app de barre de menu (point d'entrée).

L'icône de l'app est générée par script : python assets/make_icon.py && ./assets/make_icns.sh.

Licence

MIT — voir LICENSE.