convez.ai
Skill
josephjoberno

kreyol-tts-adaptation

josephjoberno/kreyol-tts-adaptation

Ver no GitHub
InicialPluginScore · de 0 a 100

Faire prononcer correctement le créole haïtien par les moteurs TTS (Gemini, ElevenLabs, fal.ai, Suno). Skill Claude Code + CLI autonome.

Instalação

$npx convez-ai josephjoberno/kreyol-tts-adaptation

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Kreyòl TTS Adaptation

Faire prononcer correctement le créole haïtien (Kreyòl ayisyen) par les moteurs de synthèse vocale grand public : Gemini TTS, ElevenLabs, fal.ai, Suno. Un skill Claude Code complet, un CLI autonome, et la connaissance linguistique pour l'étendre.

In English: a Claude Code skill and a standalone CLI that respell Haitian Creole (IPN orthography) so mainstream TTS engines, which only know French and English, pronounce it the way a Creole speaker would. Built from real production cases. The full documentation is in French in SKILL.md.

Pourquoi ce projet existe

Je construis OtomatikEdit, une plateforme de génération de vidéos pour les créateurs de contenu, dont beaucoup publient en créole haïtien pour des audiences sur TikTok, YouTube et Facebook. Aucun moteur de synthèse vocale grand public ne parle le kreyòl. Quand on leur donne un texte en orthographe IPN, deux choses se produisent :

  1. Ils lisent avec les règles du français. « Repoze » sort « reupozeu » au lieu de « répozé », « mwen » sort « mouan » au lieu de « mwin », « genyen » sort « jenyen » au lieu de « guinyin ». Les voyelles sont massacrées.

  2. Les moteurs à base de LLM vont plus loin : ils remplacent les mots. Gemini TTS ne lit pas les lettres, il reconnaît un mot proche du français et prononce LE MOT FRANÇAIS. Constaté en production : « istwa » devient « histoire », « Jezi » devient « Jésus », « Bib » devient « Bible », « Bondye » devient « Bon Dieu », « gade » devient « garder », « kwè » devient « croire », « lapriyè » devient « la prière ». Aucune règle d'orthographe ne gagne contre ça tant que le mot reste reconnaissable.

Chaque mot mal prononcé casse l'immersion d'une narration et décrédibilise la vidéo. Pour une langue parlée par plus de douze millions de personnes et quasi absente des moteurs vocaux, il fallait une solution systématique, documentée et partageable. C'est ce dépôt.

La solution en deux étages

Des règles de réécriture phonétique : le texte est réécrit, juste avant l'appel au moteur, dans une orthographe que le français lit comme du kreyòl. Le « e » devient « é », le « en » nasal devient « in », le « g » se durcit en « gu » devant e/i, le « s » intervocalique se double. Six règles, dont l'ordre compte, dérivées de la table graphème-phonème officielle de l'orthographe IPN.

Un dictionnaire d'exceptions : les mots que les moteurs LLM francisent sont remplacés par des non-mots français portant les mêmes sons. « Bib » devient « Bibe », « Bondye » devient « Bon-dyé », « istwa » devient « iss-toua », « Jezi » devient « Jé-zi ». Le moteur n'a plus rien à normaliser et lit ce qui est écrit. Le tiret casse la reconnaissance lexicale sans hacher la lecture.

Règle d'or : le texte adapté ne sert QUE pour l'appel au moteur. Les sous-titres, le script affiché à l'utilisateur, la base de données gardent toujours l'orthographe IPN authentique.

À qui ça s'adresse

  • Développeurs d'applications vidéo, audio ou e-learning qui veulent offrir des voix off en créole haïtien avec les moteurs TTS existants, sans attendre qu'un fournisseur supporte la langue.
  • Utilisateurs de Claude Code : installez le skill et Claude saura corriger un mot signalé, étendre le dictionnaire, ou vous donner la sortie moteur d'un texte.
  • La communauté tech haïtienne et créolophone : la connaissance accumulée ici (table phonétique, mots à risque constatés, méthode de forge des remplacements) est réutilisable pour n'importe quel système vocal, y compris d'autres créoles à base lexicale française.

Contenu du dépôt

FichierRôle
SKILL.mdLe skill complet : les deux modes de défaillance, la table graphème IPN vers API vers réécriture sûre, l'ordre des règles, la méthode du dictionnaire, la détection, les invariants d'architecture, le workflow de correction d'un mot, les limitations connues, le protocole de test.
scripts/adapt-creole.tsCLI autonome (zéro dépendance) : un texte entre, la sortie par moteur sort.

Installation comme skill Claude Code

Pour un projet (partagé avec l'équipe via git) :

mkdir -p .claude/skills/creole-tts-adaptation
cp -r SKILL.md scripts .claude/skills/creole-tts-adaptation/

Pour tous vos projets :

mkdir -p ~/.claude/skills/creole-tts-adaptation
cp -r SKILL.md scripts ~/.claude/skills/creole-tts-adaptation/

Claude Code détecte le skill automatiquement. Dites-lui « la voix dit garder au lieu de ga-dé » ou « donne-moi la sortie Gemini de ce texte créole » et il appliquera la méthode.

Utilisation du CLI

Nécessite bun (ou tsx/ts-node).

bun scripts/adapt-creole.ts "Mwen fatige anpil, annale lakay nou."
echo "Bondye bon" | bun scripts/adapt-creole.ts
bun scripts/adapt-creole.ts --force "Mwen fatige."   # texte court : forcer l'adaptation
bun scripts/adapt-creole.ts --json "..."             # sortie JSON programmatique

Exemple de sortie :

Texte original          : Bondye renmen nou, Jezi ap gade istwa nou.
Détecté créole          : true

Gemini TTS              : Bon-dyé rinmin nou, Jé-zi ap ga-dé iss-toua nou.
ElevenLabs              : Bon-dyé rinmin nou, Jé-zi ap ga-dé iss-toua nou.
fal.ai (voix)           : Bon-dyé rinmin nou, Jé-zi ap ga-dé iss-toua nou.
Suno (paroles chantées) : Bon-dyé rinmin nou, Jé-zi ap ga-dé iss-toua nou.
Sous-titres / affichage : Bondye renmen nou, Jezi ap gade istwa nou.

Toutes les voix parlées et les paroles chantées (Suno en mode chanson) reçoivent la même réécriture. Le champ style de Suno (description d'ambiance) et tout ce qui est affiché à l'utilisateur restent intacts.

Quelques transformations de référence

Kreyòl (IPN)Le moteur disaitIl reçoitIl dit
repozereupozeurépozérépozé
mwenmouanmwinmwin
genyenjenyenguinyinguinyin
preseprézépréssépréssé
BibBibleBibebib
istwahistoireiss-touaiss-twa
JeziJésusJé-zijé-zi
BondyeBon DieuBon-dyébon-dyé

Contribuer

Le dictionnaire d'exceptions grandit avec les signalements de terrain. Ouvrez une issue ou une PR au format :

mot écrit : gade
la voix dit : garder
attendu : ga-dé
moteur : Gemini TTS

Pour une PR : ajoutez l'entrée dans WORD_OVERRIDES (dans scripts/adapt-creole.ts) en suivant la méthode de forge documentée dans SKILL.md (non-mot français, mêmes sons, tirets aux syllabes pour les noms propres), avec le cas dans la section des transformations de référence.

Sources

Licence

MIT. Utilisez, copiez, adaptez, y compris commercialement. Si ce travail vous sert, un lien vers ce dépôt aide la communauté à le trouver.

Ver o original no GitHub

Bom para

Relacionados