Que faut-il savoir avant d'installer SillyTavern ?

SillyTavern ne se présente pas comme une application mobile classique ou un installateur .exe : c'est un petit serveur web local écrit en Node.js. Quand vous le démarrez, une fenêtre de console tourne en arrière-plan et ouvre automatiquement l'interface de chat dans votre navigateur à l'adresse http://localhost:8000.

Comme SillyTavern se contente de gérer l'interface, l'assemblage des prompts et l'historique de vos discussions pendant que l'API connectée fait tourner le modèle d'IA, vous n'avez besoin ni d'un PC gamer ni d'une carte graphique dédiée. N'importe quel ordinateur portable de bureautique ou smartphone Android récent le fait tourner sans effort. Toutes les commandes et clés de configuration ci-dessous ont été vérifiées d'après la documentation officielle de SillyTavern en novembre 2026.

Comment installer SillyTavern sur Windows ?

Sur Windows 10 ou Windows 11, la méthode la plus propre et la plus fiable consiste à installer Node.js et Git, puis à cloner la branche stable release.

Remarque : Comme le rappelle la documentation officielle d'installation Windows, n'installez jamais SillyTavern dans un dossier système contrôlé par Windows (C:\Program Files, C:\Windows\System32 ou un dossier synchronisé par OneDrive), et ne faites jamais de clic droit « Exécuter en tant qu'administrateur » sur Start.bat. Dans les deux cas, cela casse les droits d'accès aux fichiers lors de l'installation des paquets Node.js. (Windows 7 n'est pas non plus pris en charge car les versions actuelles de Node.js n'y tournent plus.)

Installation sur Windows étape par étape

  1. Installer Node.js LTS : Rendez-vous sur nodejs.org et téléchargez l'installateur LTS (Long Term Support). Lancez-le en conservant les options par défaut.
  2. Installer Git for Windows : Allez sur gitforwindows.org, téléchargez l'installateur et validez les écrans par défaut jusqu'à la fin.
  3. Choisir un dossier sain : Ouvrez l'Explorateur de fichiers (Win + E) et placez-vous dans un dossier ordinaire comme C:\Games, C:\AI ou votre dossier utilisateur.
  4. Ouvrir l'Invite de commandes à cet endroit : Cliquez directement dans la barre d'adresse en haut de l'Explorateur de fichiers, tapez cmd et appuyez sur Entrée. Une fenêtre noire d'invite de commandes s'ouvre directement dans ce dossier.
  5. Cloner la branche stable release : Collez la commande suivante et appuyez sur Entrée :
bash
git clone https://github.com/SillyTavern/SillyTavern -b release
  1. Lancer SillyTavern : Ouvrez le nouveau dossier SillyTavern dans l'Explorateur de fichiers et double-cliquez sur Start.bat (il peut s'afficher simplement sous le nom Start si Windows masque les extensions de fichiers).

Au premier démarrage, la console télécharge les paquets npm nécessaires pendant une à deux minutes, puis ouvre automatiquement http://127.0.0.1:8000 dans votre navigateur par défaut.

Astuce : Vous préférez un menu graphique pour gérer les mises à jour et les sauvegardes ? L'équipe officielle maintient également SillyTavern-Launcher, que vous pouvez cloner et lancer via installer.bat pour piloter SillyTavern en un clic.

Comment installer SillyTavern sur Android avec Termux ?

Il n'existe pas de fichier APK officiel de SillyTavern. Sur Android, on fait tourner exactement le même serveur Node.js que sur PC à l'intérieur de Termux, un environnement de terminal Linux gratuit, puis on ouvre l'interface dans Chrome, Firefox ou Brave sur son téléphone.

Remarque : N'installez surtout pas Termux depuis le Google Play Store. Comme l'indique le guide officiel SillyTavern pour Android, la version du Play Store est abandonnée et pointe vers des dépôts obsolètes qui ne fonctionnent plus. Si vous avez déjà installé la version du Play Store, désinstallez-la d'abord.

Installation sur Android (Termux) étape par étape

  1. Installer Termux depuis F-Droid ou GitHub : Téléchargez et installez l'APK de Termux depuis F-Droid (recommandé) ou depuis les Releases GitHub officielles de Termux.
  2. Choisir un miroir de paquets et mettre Termux à jour : Ouvrez Termux, lancez le sélecteur de miroir, puis mettez à jour tous les paquets de base (tapez Y puis Entrée à chaque confirmation demandée) :
bash
termux-change-repo
pkg update && pkg upgrade
  1. Installer Git, Node.js LTS et Nano : Exécutez cette commande exacte pour installer les dépendances :
bash
pkg install git nodejs-lts nano
  1. Cloner SillyTavern : Téléchargez la branche stable release dans le dossier d'accueil de Termux :
bash
git clone https://github.com/SillyTavern/SillyTavern -b release
  1. Démarrer le serveur : Entrez dans le dossier et lancez le script de démarrage :
bash
cd ~/SillyTavern
bash start.sh

Dès que la console affiche SillyTavern is listening on IPv4: 127.0.0.1:8000, ouvrez le navigateur web de votre téléphone et allez sur http://localhost:8000.

Deux réglages Android indispensables pour éviter que le serveur ne coupe

  • Activer le Wakelock de Termux : Android ferme agressivement les applications en arrière-plan pour économiser la batterie. Déroulez la barre de notifications de votre téléphone, repérez la notification Termux et appuyez sur Acquire wakelock pour empêcher Android d'endormir le serveur pendant que vous écrivez dans votre navigateur. Passez également la gestion de batterie de Termux sur « Non restreinte » dans les paramètres d'Android.
  • Activer le chargement différé si vous avez beaucoup de cartes : Si vous stockez des centaines de cartes de personnages sur votre téléphone, ouvrez Termux et tapez nano ~/SillyTavern/config.yaml pour passer lazyLoadCharacters: true et useDiskCache: false sous la section performance: (appuyez sur Ctrl + X, puis Y, puis Entrée pour enregistrer).

Comment utiliser SillyTavern sur iPhone ou iPad ?

Le système iOS d'Apple interdit aux applications de faire tourner un serveur Node.js local en arrière-plan : il est donc impossible d'installer SillyTavern directement sur un iPhone ou un iPad. À la place, on fait tourner SillyTavern sur une autre machine et on l'ouvre dans Safari sur son iPhone — l'interface s'adapte automatiquement aux écrans mobiles.

Trois solutions s'offrent à vous selon l'endroit d'où vous jouez.

Option 1 : Faire tourner SillyTavern sur son PC et jouer sur iPhone en Wi-Fi (Gratuit et privé)

Si vous jouez chez vous avec votre ordinateur allumé, votre iPhone peut se connecter directement au serveur SillyTavern de votre PC via votre réseau Wi-Fi domestique.

  1. Lancez SillyTavern au moins une fois sur votre PC pour qu'il génère son fichier de configuration, puis fermez la fenêtre du serveur.
  2. Ouvrez le fichier /SillyTavern/config.yaml situé à la racine de votre dossier SillyTavern avec le Bloc-notes ou tout autre éditeur de texte. (Attention à bien modifier /SillyTavern/config.yaml à la racine, et non /SillyTavern/default/config.yaml.)
  3. Conformément au guide officiel des connexions à distance, remplacez listen: false par listen: true.
  4. Configurer le contrôle d'accès (obligatoire) : Par sécurité, SillyTavern refuse de démarrer avec listen: true si vous n'activez pas soit une liste blanche d'adresses IP (whitelist), soit un mot de passe. Pour jouer sur le Wi-Fi de la maison, repérez la section whitelist: dans config.yaml et autorisez les plages de réseau local standard :
yaml
listen: true
whitelistMode: true
whitelist:
  - ::1
  - 127.0.0.1
  - 192.168.0.0/16
  - 10.0.0.0/8
  - 172.16.0.0/12
  1. Trouvez l'adresse IPv4 locale de votre PC : appuyez sur Win + R, tapez cmd, lancez ipconfig et cherchez la ligne Adresse IPv4 / IPv4 Address (par exemple 192.168.1.25).
  2. Relancez SillyTavern sur votre PC (autorisez Node.js dans le pare-feu Windows sur les réseaux privés si une fenêtre s'affiche). Sur votre iPhone, ouvrez Safari et rendez-vous sur http://192.168.1.25:8000 (utilisez bien http:// et non https://).

Option 2 : Jouer en 4G/5G hors de chez soi grâce à Tailscale (Gratuit et sécurisé)

N'ouvrez jamais le port 8000 de votre box internet directement sur le web public. Si vous voulez jouer sur votre iPhone dans les transports ou en déplacement, le guide officiel de tunneling SillyTavern recommande Tailscale, un réseau privé virtuel (VPN mesh) gratuit.

  1. Installez Tailscale sur votre PC ainsi que depuis l'App Store sur votre iPhone, puis connectez-vous aux deux appareils avec le même compte.
  2. Dans /SillyTavern/config.yaml, réglez listen: true, passez whitelistMode: false, et activez la protection par mot de passe HTTP (basicAuthMode: true) :
yaml
listen: true
whitelistMode: false
basicAuthMode: true
basicAuthUser:
  username: "votre-pseudo"
  password: "un-mot-de-passe-solide"
  1. Redémarrez SillyTavern sur votre PC. Activez Tailscale sur votre iPhone, copiez l'adresse IP Tailscale de votre PC (100.x.y.z) depuis l'application Tailscale, et ouvrez http://100.x.y.z:8000 dans Safari.

Option 3 : SillyTavern hébergé dans le cloud (VPS ou instance cloud)

Si vous n'avez pas d'ordinateur ou que vous ne voulez pas le laisser allumé, vous pouvez installer SillyTavern sur un petit serveur privé virtuel (VPS) ou passer par un hébergeur spécialisé.

  • L'avantage : Votre page SillyTavern reste accessible 24h/24 depuis n'importe quel iPhone ou iPad sans laisser tourner de machine chez vous.
  • Le compromis (coût et vie privée) : Un petit VPS privé coûte quelques euros par mois et demande quelques bases sous Linux. En revanche, méfiez-vous des « instances SillyTavern partagées » à bas prix gérées par des inconnus : la personne qui administre le serveur a un accès direct à votre dossier data/, c'est-à-dire à vos historiques de RP privés, à vos cartes et à vos clés API enregistrées. Si vous choisissez le cloud, louez votre propre VPS personnel et activez toujours basicAuthMode: true derrière une connexion HTTPS.

À quoi servent les 9 icônes de la barre supérieure de SillyTavern ?

Lorsque vous ouvrez http://localhost:8000 pour la première fois, vous voyez une rangée de neuf icônes tout en haut de l'écran. Voici à quoi sert chacune d'elles, de gauche à droite :

OrdreNom officiel dans l'interfaceApparence de l'icôneRôle concret
1AI Response ConfigurationTrois curseurs horizontauxRègle la longueur des réponses, la température et le Chat Completion Prompt Manager (où l'on importe les presets et où l'on active/désactive les blocs du prompt).
2API ConnectionsPrise électriqueConnecte SillyTavern à votre fournisseur de modèles d'IA : c'est ici que vous choisissez Chat Completion, collez l'URL de l'endpoint et votre clé API, puis sélectionnez le modèle.
3Advanced FormattingLettre A majusculeGère les modèles de contexte et d'instructions (Context / Instruct) pour les moteurs locaux en mode Text Completion ; si vous utilisez une API en Chat Completion (Claude, Gemini, DeepSeek), vous n'avez pas besoin d'y toucher.
4World InfoGlobe terrestre posé sur un livrePermet de créer et d'importer des Lorebooks : des fiches d'univers déclenchées par mots-clés qui ne sont injectées dans le prompt que lorsqu'on les mentionne dans le chat.
5User SettingsSilhouette avec engrenagePersonnalise le thème visuel, la taille de police, la disposition des bulles de dialogue et le comportement de l'interface.
6BackgroundsCadre de paysageChange l'image de fond derrière votre fenêtre de discussion.
7ExtensionsTrois cubes 3DGère les outils intégrés (scripts Regex, résumé automatique du chat, pièces jointes) et permet d'installer des plugins tiers depuis GitHub.
8Persona ManagementVisage souriantDéfinit qui est {{user}} — votre nom, votre avatar et la description de votre personnage joueur — et permet d'associer différents personas à différentes histoires.
9CharactersFiche de contact (tout à droite)Ouvre votre bibliothèque de personnages pour importer des cartes .png ou .json, lancer un nouveau chat ou créer un salon de groupe à plusieurs personnages.

Comment connecter une API et lancer votre premier RP ?

Comme SillyTavern n'embarque aucun modèle d'IA par défaut, l'icône de prise électrique (API Connections) est votre première étape obligatoire avant d'envoyer un message. Voici comment brancher TavernAPI et charger notre preset de roleplay en moins de deux minutes :

  1. Ouvrir API Connections (l'icône de prise électrique) : Réglez API sur Chat Completion, puis Chat Completion Source sur Custom (OpenAI-compatible).
  2. Renseigner l'URL et votre clé API :
    • Custom Endpoint (Base URL) : https://tavernapi.com/v1 (n'ajoutez pas /chat/completions à la fin)
    • Custom API Key : Collez votre clé sk-tav-... générée dans la console TavernAPI.
  3. Se connecter et choisir un modèle : Cliquez sur Connect, puis ouvrez le menu déroulant Available Models et sélectionnez l'un de nos cinq modèles officiels à fenêtre de contexte de 1M de tokens — comme gemini-4-argon, claude-opus-5.5 ou deepseek-v4-pro (consultez notre comparatif détaillé des modèles pour le roleplay si vous hésitez sur lequel choisir).
  4. Importer le preset TavernAPI : Téléchargez le fichier JSON du preset depuis votre console, ouvrez AI Response Configuration (l'icône des trois curseurs tout à gauche) et cliquez sur le bouton Import à côté de Chat Completion Presets. Vous pouvez activer ou désactiver librement la longueur de réponse, la langue de sortie ou la règle anti-impersonation dans la liste de prompts de SillyTavern, tandis que les blocs d'écriture verrouillés ([[tav:...]]) sont développés automatiquement sur notre serveur avec mise en cache automatique du prompt.

En cas de code d'erreur à la connexion (401, 402 ou 429) ou pour comprendre en détail le fonctionnement des presets verrouillés côté serveur, consultez notre guide complet de configuration et de dépannage API SillyTavern, découvrez comment fonctionnent nos presets de roleplay, comparez les autres outils de roleplay IA, ou parcourez notre page des tarifs et notre FAQ.