Distribution
Installer et distribuer murmurai en tant qu'application macOS.
Installation via DMG
La méthode recommandée pour installer murmurai est via le DMG disponible sur la page GitHub Releases :
1. Rendez-vous sur https://github.com/vbarrai/murmurai/releases
2. Téléchargez le fichier murmurai.dmg de la dernière version
3. Ouvrez le DMG et glissez murmurai dans /Applications
4. Lancez murmurai depuis /Applications ou Spotlight
Le modèle Whisper se télécharge automatiquement au premier lancement. Aucune installation de Python n'est requise.
Build automatisé via GitHub Actions
Le DMG est généré automatiquement via GitHub Actions. À chaque push d'un tag de version (ex. v0.2.0), le workflow CI :
1. Construit l'application via PyInstaller
2. Génère le DMG
3. Publie le DMG en tant qu'asset sur la page GitHub Releases
Cela garantit que chaque release dispose d'un DMG prêt à l'emploi.
Build local — Dépendances
Pour créer un build local, installez les dépendances de build (PyInstaller) :
pip install -e ".[build]"
Build local — Créer le bundle
La commande make build génère un bundle .app dans le répertoire .build/ sans l'installer :
make build
Build local — Installer dans /Applications
La commande make install crée le bundle et le copie automatiquement dans /Applications/ :
make install
Fonctionnement du build
Le processus de build utilise PyInstaller avec le fichier de configuration murmurai.spec :
1. PyInstaller analyse les imports Python et collecte toutes les dépendances
2. Le modèle faster-whisper et les bibliothèques natives sont inclus
3. Un bundle macOS (.app) est généré, autonome et sans dépendance Python externe
4. L'app peut être distribuée et exécutée sur n'importe quel Mac compatible
Le fichier murmurai.spec contient la configuration PyInstaller — icônes, métadonnées, fichiers inclus, etc.
Application standalone vs développement
Il y a deux façons d'utiliser murmurai :
Mode DMG/standalone — Téléchargez le DMG depuis GitHub Releases ou créez-le localement. Application .app dans /Applications/. Pas besoin de Python installé, pas d'environnement virtuel. Double-cliquer pour lancer. Idéal pour un usage quotidien.
Mode développement — Exécution directe depuis le code source via python/pip. Idéal pour le développement et le test de modifications. Les changements de code sont immédiatement disponibles sans rebuild.