sag

Que fait sag ?

Utilisez sag pour la synthèse vocale ElevenLabs avec lecture locale.

Clé API (obligatoire)

• ELEVENLABS_API_KEY (recommandé)
• SAG_API_KEY également pris en charge par le CLI
• Fichier de clé via --api-key-file, ELEVENLABS_API_KEY_FILE ou SAG_API_KEY_FILE

Démarrage rapide

• sag "Bonjour tout le monde"
• sag speak -v "Roger" "Bonjour"
• sag voices
• sag prompting (conseils spécifiques aux modèles)

Notes sur les modèles

• Par défaut : eleven_v3 (expressif)
• Stable : eleven_multilingual_v2
• Rapide : eleven_flash_v2_5

Règles de prononciation et de délivrance

• Première correction : réécrire (ex. "key-note"), ajouter des traits d'union, ajuster la casse.
• Nombres/unités/URLs : --normalize auto (ou off si cela nuit aux noms).
• Biais de langue : --lang en|de|fr|... pour guider la normalisation.
• v3 : SSML <break> non pris en charge ; utilisez [pause], [short pause], [long pause].
• v2/v2.5 : SSML <break time="1.5s" /> pris en charge ; <phoneme> non exposé dans sag.

Balises audio v3 (à placer au début d'une ligne)

• [whispers], [shouts], [sings]
• [laughs], [starts laughing], [sighs], [exhales]
• [sarcastic], [curious], [excited], [crying], [mischievously]
• Exemple : sag "[whispers] gardez ça discret. [short pause] d'accord ?"

Voix par défaut

• ELEVENLABS_VOICE_ID ou SAG_VOICE_ID

Confirmez la voix et le locuteur avant une sortie longue.

Réponses vocales dans le chat

Lorsque l'utilisateur demande une réponse "vocale" (ex. "voix de scientifique fou", "explique en voix"), générez un fichier audio et envoyez-le :

# Générer un fichier audio
sag -v Clawd -o /tmp/voice-reply.mp3 "Votre message ici"

# Puis inclure dans la réponse :
# MEDIA:/tmp/voice-reply.mp3

Conseils pour les personnages vocaux :

• Scientifique fou : Utilisez les balises [excited], pauses dramatiques [short pause], variez l'intensité
• Calme : Utilisez [whispers] ou un rythme plus lent
• Dramatique : Utilisez [sings] ou [shouts] avec parcimonie

Voix par défaut pour Clawd : lj2rcrvANS3gaWWnczSX (ou simplement -v Clawd)