Installation

La méthode la plus simple pour installer et mettre à jour murmurai :

brew install --cask vbarrai/tap/murmurai

Vous pouvez aussi télécharger le DMG depuis 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 Le modèle Whisper (~500 Mo pour "small") se télécharge automatiquement au premier lancement.

murmurai fonctionne exclusivement sur macOS. Pour l'installation via DMG, vous avez uniquement besoin de : • macOS (version récente recommandée) • Un microphone (intégré ou externe) • ~500 Mo d'espace disque pour le modèle Whisper "small" Pour l'installation développeur, ajoutez : • Python 3.9 ou supérieur

Pour contribuer ou modifier le code source, commencez par cloner le repository GitHub :

git clone https://github.com/vbarrai/murmurai
cd murmurai

Créez et activez un environnement Python isolé :

python3 -m venv .venv
source .venv/bin/activate

Installez murmurai en mode développement (editable) :

pip install -e .

Lancez murmurai — le modèle Whisper sera téléchargé automatiquement au premier lancement (~500 Mo pour le modèle "small") :

murmurai

Au premier lancement, macOS vous demandera trois permissions : 1. Accessibilité — Nécessaire pour détecter le raccourci clavier global (Option droite). Accordez cette permission dans Préférences Système > Confidentialité > Accessibilité. 2. Microphone — Nécessaire pour capturer l'audio. La permission est demandée automatiquement. 3. Automation (System Events) — Nécessaire pour simuler le collage (Cmd+V) à la position du curseur. Ces permissions sont demandées automatiquement lors du premier lancement. L'application s'active immédiatement après autorisation, sans redémarrage.