Contribuer
Comment contribuer au développement de murmurai.
Mise en place de l'environnement
Clonez le repository et installez en mode développement :
git clone https://github.com/vbarrai/murmurai cd murmurai python3 -m venv .venv source .venv/bin/activate pip install -e .
Lancer en développement
En mode développement, les modifications du code source sont immédiatement disponibles grâce à l'installation editable (pip install -e .) :
# Lancer murmurai murmurai # Les modifications dans murmurai/*.py sont prises en # compte immédiatement au prochain lancement
Structure des fichiers à modifier
Les fichiers principaux à connaître :
• murmurai/app.py — Logique principale, boucle push-to-talk, détection hotkey
• murmurai/recorder.py — Capture audio, gestion du microphone
• murmurai/transcriber.py — Transcription Whisper, configuration du modèle
• murmurai/paster.py — Collage automatique via System Events
• pyproject.toml — Dépendances et métadonnées du package
• murmurai.spec — Configuration PyInstaller pour le build standalone
• Makefile — Commandes de build et d'installation
Tester les builds
Vérifiez que l'application se compile correctement en standalone :
# Installer les dépendances de build pip install -e ".[build]" # Créer le bundle (sans installer) make build # Ou créer et installer dans /Applications make install
Liens utiles
• Repository GitHub : github.com/vbarrai/murmurai
• Issues : github.com/vbarrai/murmurai/issues
• faster-whisper : github.com/SYSTRAN/faster-whisper
• Licence : MIT