Aller au contenu principal

Intégration domotique Phonon TTS, gratuite et open source

Intégration Phonon TTS pour Gladys Assistant

Synthèse vocale hors ligne : Gladys parle avec les voix Phonon de Gradium, sur votre machine.

Phonon TTS donne à Gladys une voix hors ligne : les textes à prononcer (annonces des scènes « Jouer une notification ») sont synthétisés sur votre machine Gladys par les modèles Phonon de Gradium, sans service cloud ni abonnement. Une fois le modèle téléchargé, aucune connexion Internet n'est nécessaire.

Prérequis​

  • Gladys 5.3 ou plus récent (voix enfichables).

  • Gladys en mode réseau host (installation standard) : les enceintes (Sonos, Google Cast, AirPlay…) téléchargent l'audio sur une adresse de votre réseau local.

  • Environ 1 Go de mémoire et 150 Mo de disque libres pour le moteur vocal. Un Raspberry Pi 4 ou 5 convient.

  • Pour les modèles Phonon 40m (toutes les langues) : un compte Hugging Face gratuit.

    1. Ouvrez la page du modèle, par exemple gradium/phonon-40m-fr, et acceptez ses conditions d'utilisation (validation immédiate).
    2. Créez un token en lecture sur huggingface.co/settings/tokens.

    Le modèle Phonon 31m (anglais uniquement) ne demande pas de compte.

Les modèles Phonon 40m sont sous licence CC BY-NC 4.0 (usage non commercial) ; Phonon 31m et les voix du catalogue sont sous licence Apache 2.0.

Configuration​

Juste après l'installation, l'intégration ne parle pas : aucun modèle n'est choisi par défaut et rien n'est téléchargé.

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Choisissez le modèle : un modèle 40m dans votre langue (le meilleur choix), le modèle multilingue (choisissez alors sa langue), ou Phonon 31m pour l'anglais sans compte.
  3. Pour un modèle 40m, collez votre token Hugging Face. Il ne sert qu'au téléchargement et n'est jamais transmis au moteur vocal.
  4. Choisissez la voix : la voix du modèle, ou l'une des 102 voix du catalogue Phonon. Écoutez-les d'abord sur la page de démonstration des voix, qui indique le nom exact à choisir dans la liste. Toutes les voix fonctionnent avec tous les modèles, mais sonnent mieux dans leur langue.
  5. Enregistrez. L'état en haut de l'écran suit le téléchargement (environ 75 Mo), puis le démarrage du moteur, jusqu'à Prêt.
  6. Faites de Phonon TTS la voix de Gladys : Intégrations › Intelligence artificielle › Voix, choisissez Phonon TTS.

Vos scènes « Jouer une notification » parlent désormais avec Phonon.

Seuls le modèle et la voix sélectionnés sont gardés sur le disque : changer de modèle ou de voix supprime les précédents. Pendant le téléchargement d'un nouveau modèle, la voix actuelle continue de parler.

Voix personnalisée (Gradium Studio)​

Une voix créée ou clonée dans Gradium Studio fonctionne aussi :

  1. Créez une clé API dans Gradium Studio et collez-la dans Clé API Gradium, puis enregistrez.
  2. Lancez l'action Lister mes voix Gradium Studio : elle affiche l'identifiant de chacune de vos voix.
  3. Choisissez Voix personnalisée dans la liste des voix, collez l'identifiant dans Voix personnalisée et enregistrez.

Vous pouvez aussi y indiquer l'URL https d'un fichier de voix Phonon (.safetensors). La voix n'est téléchargée qu'une fois.

Réglages avancés​

  • Débit de parole : plus lent, normal ou plus rapide.
  • Poids du modèle : q8 (recommandé) est plus léger et plus rapide sur un processeur ; f32 est plus lourd et plus lent.

Actions​

  • Tester la voix : synthétise une phrase (la vôtre, ou une phrase d'exemple) et indique la durée de parole générée et le temps de calcul.
  • Lister mes voix Gradium Studio : voir ci-dessus.
  • Relancer le moteur vocal : relance le téléchargement et redémarre le moteur, par exemple après une coupure réseau.

Limites​

  • L'assistant vocal répond en texte avec Phonon TTS : sa page est en HTTPS, et le navigateur refuse de lire l'audio servi en HTTP sur le réseau local. Les annonces des scènes, elles, parlent normalement.
  • Gladys attend une synthèse 30 secondes au plus. Sur une machine modeste, un texte très long est coupé et seul son début est prononcé.
  • Une seule langue par modèle (celle du modèle, ou celle choisie pour le multilingue) : un texte dans une autre langue est lu avec l'accent du modèle.

Dépannage​

  • « Aucun modèle sélectionné » : choisissez un modèle et enregistrez.
  • « Modèle à accès restreint » / « Accès refusé » : acceptez les conditions sur la page Hugging Face du modèle avec le compte du token, vérifiez le token, puis enregistrez de nouveau.
  • « Impossible de joindre Hugging Face » : Gladys a besoin d'Internet pour le premier téléchargement. Vérifiez la connexion, puis lancez Relancer le moteur vocal.
  • Le moteur s'arrête au démarrage : consultez les journaux du conteneur phonon dans le bloc Supervision (mémoire insuffisante, processeur non pris en charge…).
  • Les enceintes ne jouent rien : vérifiez que Gladys tourne en mode réseau host et que Phonon TTS est bien la voix choisie dans Intégrations › Intelligence artificielle.
  • Les journaux de l'intégration (bloc Supervision) détaillent chaque étape.

Signalez un problème sur github.com/bertrandda/gladys-phonon.

Paramètres de configuration​

Voici les paramètres demandés par Phonon TTS dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Modèle PhononsectionNonRien n'est téléchargé et Gladys ne peut pas parler tant que vous n'avez pas choisi un modèle et enregistré. Les modèles 40m demandent un compte Hugging Face gratuit : ouvrez la page du modèle, acceptez ses conditions (validation immédiate), puis créez un token en lecture. Ils sont sous licence CC BY-NC 4.0 (usage non commercial). Phonon 31m (anglais) est sous licence Apache 2.0 et ne demande pas de compte. Une fois téléchargé, tout fonctionne hors ligne.
ModèleselectOuiChaque modèle 40m parle une langue. Le multilingue parle les cinq : choisissez sa langue ci-dessous.
Langue (modèle multilingue uniquement)selectNonFaçon de lire les nombres, les dates et les symboles. Ignoré par les modèles d'une seule langue.
Token Hugging FacesecretNonToken en lecture du compte qui a accepté les conditions du modèle. Sert uniquement à télécharger un modèle 40m, jamais transmis au moteur de synthèse.
VoixsectionNonChoisissez la voix du modèle ou l'une des voix du catalogue Phonon : écoutez-les d'abord sur la page de démonstration. Seule la voix choisie est téléchargée. Toutes les voix fonctionnent avec tous les modèles, mais sonnent mieux dans leur langue. Vous pouvez aussi utiliser une voix créée ou clonée dans Gradium Studio.
VoixselectNon
Voix personnaliséestringNonUtilisé quand la voix est « Voix personnalisée » : l'identifiant d'une voix créée ou clonée dans Gradium Studio (l'action « Lister mes voix Gradium Studio » ci-dessous les affiche), ou l'URL https d'un fichier de voix Phonon (.safetensors).
Clé API GradiumsecretNonUniquement pour une voix personnalisée donnée par son identifiant : créez une clé dans Gradium Studio. La voix est téléchargée une fois, puis fonctionne hors ligne.
AvancésectionNonLes valeurs par défaut conviennent à la plupart des installations.
Débit de paroleselectNon
Poids du modèleselectNonq8 est plus léger et plus rapide sur un processeur, pour une qualité de voix équivalente dans la plupart des usages.

Comment installer Phonon TTS dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Phonon TTS apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/bertrandda/gladys-phonon:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/bertrandda/gladys-phonon.

Phonon TTS nécessite Gladys >=5.3.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Phonon TTS est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par bertrandda, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂