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