Le projet existe deja, il est open source. Il lui manque une chose : une voix credible. Par defaut, il parle avec la voix de votre navigateur, plate et mecanique. Ce manuel corrige ca en trois etapes et un seul prompt.
- → Temps necessaire : une dizaine de minutes
- → Niveau : debutant, aucune ligne de code a ecrire
- → Cout : votre abonnement Claude Code, plus le modele gratuit de Fish Audio
1. Jarvis, comment ca marche
Jarvis tient en trois pieces. Comprendre leur role vous evitera la plupart des pannes.
Le visage : votre navigateur. Il ecoute le mot d eveil "Hey Jarvis", detecte quand vous parlez, transcrit votre voix en texte et affiche l interface holographique. C est aussi lui qui joue le son de la reponse.
Le cerveau : Claude Code, en coulisses. Un petit programme tourne sur votre machine. Il fait fonctionner Claude Code sans fenetre, comme un moteur. C est lui qui reflechit et qui utilise vos outils : recherche web, mails, images, telephone. Il utilise votre abonnement Claude Code existant, sans cle API supplementaire.
La voix : Fish Audio. C est la piece que vous allez ajouter. Le cerveau produit une reponse en texte. Fish Audio la transforme en voix naturelle.
Le visage et le cerveau se parlent en local, sur votre ordinateur (adresse localhost:8787). En revanche, plusieurs services en ligne interviennent : Claude pour reflechir, la reconnaissance vocale de Chrome pour transcrire, vos outils pour agir, et desormais Fish Audio pour prononcer. Gardez-le en tete avant de lui dicter quelque chose de confidentiel.
2. Pourquoi changer de voix
La voix du navigateur fonctionne. Mais elle trahit la machine des la premiere phrase.
| Voix du navigateur | Fish Audio | |
|---|---|---|
| Rendu | ton plat, debit mecanique | intonation, pauses, respiration |
| Regularite | change selon l ordinateur et le navigateur | la meme voix partout |
| Mise en place | rien a faire | un compte, une cle API |
| Cout | gratuit | modele gratuit disponible pour tester |
La difference n est pas cosmetique. Un assistant vocal, on l ecoute. Une voix penible a ecouter, c est un assistant qu on arrete d utiliser au bout de deux jours.
Bon a savoir : Fish Audio n est pas prevu d origine dans Jarvis. Le projet prevoit une autre voix en option (ElevenLabs). Vous allez demander a Claude Code de brancher Fish Audio a la place. C est precisement l interet de l exercice : vous ne suivez pas un tutoriel fige, vous faites adapter un projet existant a votre besoin.
3. Les trois etapes
Avant de commencer
Verifiez ces trois points. Ils sont gratuits, sauf le premier que vous avez sans doute deja.
- Claude Code installe et connecte. Lancez
claudeune fois dans un terminal pour verifier que vous etes bien connecte. - Node.js version 20 ou plus. Telechargeable sur nodejs.org. Tapez
node -vpour connaitre votre version. - Google Chrome ou Microsoft Edge. Jarvis a besoin du micro et de l affichage 3D de ces navigateurs.
Etape 1 : creez votre compte Fish Audio
Rendez-vous sur fish.audio et creez un compte. Une adresse mail suffit.
Etape 2 : recuperez votre cle API
Ouvrez la page fish.audio/app/api-keys et creez une cle. Copiez-la. Cette cle, c est votre carte bancaire chez Fish Audio. Trois regles :
- → Ne la collez jamais dans un mail, un document partage ou une capture d ecran.
- → Ne la publiez jamais dans un depot de code public (GitHub, GitLab). Des robots scannent ces depots en permanence pour recuperer les cles.
- → Si vous pensez l avoir exposee, supprimez-la sur la meme page et creez-en une nouvelle. Ca prend dix secondes.
Etape 3 : donnez le travail a Claude Code
Ouvrez un terminal, placez-vous dans le dossier ou vous voulez installer Jarvis, lancez claude et collez ce prompt, en remplacant le crochet par votre cle :
Claude Code va vous demander des autorisations au fil de l eau (telecharger le projet, installer les dependances, modifier des fichiers). Lisez-les et acceptez. C est normal, et c est sain : vous gardez la main.
4. Le prompt, ligne par ligne
Un bon prompt n a rien de magique. Chaque morceau repond a une question que Claude Code se poserait sinon.
- "Installe le projet github.com/adewaskar/jarvis sur ma machine." Le point de depart. Claude Code telecharge le projet et installe tout ce dont il a besoin.
- "Remplace la voix par Fish Audio." L objectif. Claude Code lit le code, trouve l endroit ou Jarvis fabrique sa voix et le reecrit. C est la partie qui vous aurait pris une apres-midi seul.
- "Utilise l API api.fish.audio/v1/tts." L adresse precise. Sans elle, Claude Code devrait la chercher et pourrait se tromper de version.
- "Avec le modele s2.1-pro-free." Le modele gratuit de Fish Audio. C est le meme moteur que la version payante, sans garantie de delai de reponse. Parfait pour tester et pour un usage personnel.
- "Et ma cle API." Votre acces. Elle reste sur votre machine.
- "Puis lance Jarvis." Claude Code demarre le cerveau et le visage, puis vous donne l adresse a ouvrir.
Deux phrases a ajouter, selon vous
Pour un Jarvis qui parle francais. D origine, Jarvis ecoute et repond en anglais (britannique, comme le personnage). Ajoutez a la fin du prompt :
Pour proteger votre cle. Si vous comptez un jour publier votre version du projet, ajoutez :
C est une bonne habitude, meme si vous ne publiez rien.
5. Premier test
- Ouvrez http://localhost:5173 dans une vraie fenetre Chrome ou Edge.
- Cliquez sur INITIALISE.
- Autorisez le micro quand le navigateur le demande.
- Dites "Hey Jarvis", puis votre question.
Les raccourcis a connaitre
| Touche | Effet |
|---|---|
| Espace | parler sans dire "Hey Jarvis" |
| Echap | arreter Jarvis |
| D | panneau de diagnostic |
| T | test audio en une ligne |
Vous pouvez aussi lui couper la parole : parlez pendant qu il repond, il s arrete et vous ecoute.
Il ne vous entend pas ?
- → Vous etes dans un panneau d apercu. C est la cause numero un. Les apercus integres aux editeurs de code (y compris celui de Claude Code) bloquent le micro. L interface s affiche, s anime, et n entend jamais rien. Ouvrez l adresse dans une vraie fenetre de navigateur.
- → Le micro n est pas autorise. Cliquez sur l icone a gauche de l adresse dans Chrome et autorisez le micro.
- → Vous ne savez pas ce qui coince. Appuyez sur D : le panneau dit clairement s il vous entend et s il produit du son. Appuyez sur T pour un test audio.
- → Il entend, mais ne parle pas avec la nouvelle voix. Demandez a Claude Code : "Jarvis utilise encore la voix du navigateur, verifie l appel a Fish Audio." Jarvis est concu pour repasser sur la voix du navigateur quand la voix en ligne echoue : la cause est souvent une cle mal recopiee.
6. La securite : ce que Jarvis ne fera pas sans vous
Un assistant qui agit avec vos outils pose une vraie question. Que se passe-t-il s il comprend mal ? Le projet a fait un choix prudent : Jarvis demarre en lecture seule.
- → Autorise d office : chercher, lire, consulter, generer une image. Rien ne change dans le monde reel.
- → Bloque d office : envoyer un mail, supprimer un fichier, installer un logiciel, payer, toucher l ecran de votre telephone.
Pourquoi bloquer a l avance plutot que demander confirmation ? Parce que la voix est une mauvaise interface pour valider une action. Un "oui" mal compris, et le mail part. La decision est donc prise une fois, dans le code, avant la conversation.
Pour autoriser les actions, il faut relancer Jarvis avec une commande dediee (npm run bridge:writes). Faites-le en connaissance de cause : "Hey Jarvis, fais du menage dans mes telechargements" n a pas le meme sens en lecture seule et avec les actions activees.
Notre conseil : restez en lecture seule pendant au moins une semaine. Vous verrez vite ce qu il comprend bien et ce qu il comprend mal.
7. Ce que Jarvis peut faire pour une PME
Jarvis reste un projet personnel, pas un logiciel d entreprise. Mais il montre tres concretement ou va le travail avec l IA. Quelques usages realistes, en lecture seule :
- → Le point du matin. "Hey Jarvis, resume mes mails non lus et dis-moi lesquels demandent une reponse aujourd hui."
- → La veille avant un rendez-vous. "Que sait-on de cette entreprise ? Actualites, taille, dirigeants." Pendant que vous enfilez votre veste.
- → Les visuels rapides. "Genere trois idees de visuel pour notre post de demain sur le salon."
- → Les mains prises. En atelier, en cuisine, en reunion debout : poser une question sans toucher un clavier.
Le plus interessant n est pas Jarvis lui-meme. C est la methode : prendre un projet open source, le faire adapter par Claude Code a votre besoin en une phrase, et comprendre ce qu il a change. C est exactement ce qu on apprend a faire en formation.
Ce qu il faut retenir
- Jarvis = un visage (le navigateur), un cerveau (Claude Code) et une voix (Fish Audio).
- Trois etapes : un compte Fish Audio, une cle API, un prompt dans Claude Code.
- Votre cle ne se partage pas et ne se publie pas.
- Ouvrez Jarvis dans une vraie fenetre Chrome, sinon il n entend rien.
- Il demarre en lecture seule : gardez-le ainsi le temps de le connaitre.
