Retour au blog

Installer et configurer KataGo automatiquement sur Windows, macOS et Linux

Publié le 6 avril 2026 par StoneBase Team

KataGo est l’un des IA de Go open-source les plus puissantes disponibles aujourd’hui. Que vous vouliez comprendre où vous vous êtes trompé dans une partie, explorer des coups alternatifs, ou étudier le jeu de niveau professionnel, KataGo vous fournit une analyse coup par coup avec des taux de victoire, des estimations de score et les meilleures variations.

Depuis StoneBase 1.0.65, vous pouvez configurer KataGo directement dans l’application : l’assistant détecte votre ordinateur, télécharge des fichiers compatibles et teste l’analyse avant votre confirmation. Commencez par la configuration automatique ci-dessous, ou suivez les instructions manuelles pour choisir vous-même l’exécutable, le réseau neuronal et la configuration d’analyse.

Configuration automatique de KataGo dans StoneBase

Les captures montrent la véritable interface dans une démonstration isolée, avec des valeurs d’exemple. Les fichiers et versions choisis dépendent de votre ordinateur et peuvent changer.

1. Installer StoneBase et ouvrir les paramètres du moteur

Téléchargez StoneBase depuis la dernière version officielle : choisissez l’installateur .msi sous Windows, .dmg sous macOS ou .deb sous Linux. Installez et ouvrez l’application, puis allez dans Paramètres → Moteur.

Sur une nouvelle installation, cliquez sur Configurer KataGo automatiquement. L’assistant apparaît uniquement lorsqu’aucun paramètre du moteur d’analyse n’est enregistré ; une configuration partiellement enregistrée le masque également. Si vous avez déjà configuré un moteur, utilisez les paramètres manuels expliqués plus bas.

Paramètres du moteur StoneBase avec le bouton Configurer KataGo automatiquement avant le démarrage
Lancez l’assistant depuis les paramètres du moteur.

2. Laisser StoneBase détecter, télécharger et tester

StoneBase vérifie le système d’exploitation, l’architecture, le matériel compatible et la mémoire disponible. Il choisit une version compatible de KataGo et télécharge le réseau le plus fort dont la force est confirmée, indiqué comme Strongest confidently-rated network dans le catalogue officiel de réseaux KataGo. Il prépare ensuite une configuration d’analyse et exécute une petite requête d’analyse réelle sur votre ordinateur avant de proposer un enregistrement. Le choix dépend de la compatibilité et du catalogue disponible ; aucun environnement GPU précis n’est garanti.

Configuration automatique de KataGo montrant le matériel détecté et la progression du téléchargement du réseau
Vérifiez le backend détecté et la progression du téléchargement.

Sous macOS : autoriser l’installation de KataGo

La configuration automatique nécessite que Homebrew soit déjà installé. StoneBase vous demande d’autoriser l’installation de KataGo avec Installer avec Homebrew et affiche la commande qu’il exécutera :

brew install --force-bottle katago

Cette autorisation installe KataGo, pas Homebrew. L’exécutable et ses bibliothèques restent dans Homebrew. Le réseau, la configuration d’analyse et les autres fichiers gérés se trouvent dans le dossier de données configurable de StoneBase. Sous Windows et Linux, l’assistant gère aussi le moteur téléchargé dans ce dossier.

Écran de consentement macOS montrant la commande Homebrew pour installer KataGo
Vérifiez la commande d’installation de KataGo avant de l’autoriser.

3. Vérifier le résultat et confirmer

Lorsque la véritable analyse de test réussit, vérifiez le backend détecté, les chemins des fichiers, les paramètres d’analyse proposés et le résultat du test. Rien n’est enregistré avant de cliquer sur Confirmer et enregistrer.

Écran de vérification KataGo avec fichiers proposés, paramètres d'analyse et bouton Confirmer et enregistrer
Vérifiez les fichiers proposés, les paramètres d’analyse et le résultat du test avant d’enregistrer.

Après l’enregistrement, cliquez sur Démarrer le moteur, ou importez un SGF et analysez votre première partie : demander une analyse démarre automatiquement le moteur configuré. Démarrer le moteur au lancement de l’application reste désactivé ; ouvrir StoneBase seul ne démarre donc pas KataGo. Cet assistant configure le moteur d’analyse ; les moteurs pour Jouer se règlent séparément.

Si un téléchargement ou l’analyse de test échoue, ou si le réseau choisi exige plus de ressources que votre ordinateur ne peut en fournir, l’assistant n’enregistre aucun paramètre. Il ne remplace pas silencieusement le réseau par un modèle plus petit. Suivez le message, réessayez si cela convient ou utilisez la configuration manuelle pour choisir des fichiers compatibles et, si nécessaire, un réseau plus petit.

Configuration manuelle avec vos propres fichiers KataGo

Suivez les étapes ci-dessous si vous avez déjà KataGo, souhaitez choisir un backend ou un réseau précis, ou ne pouvez pas terminer la configuration automatique.

Étape 1 : Télécharger KataGo

Vous aurez besoin du moteur KataGo lui-même. Un GPU est recommandé (NVIDIA, AMD ou Apple Silicon) — KataGo fonctionne aussi sur CPU, mais un GPU rend l’analyse considérablement plus rapide.

Au 13 octobre 2026, la dernière version officielle est KataGo v1.18.2, qui fournit des compilations CUDA. Pour TensorRT, OpenCL, Eigen/CPU et Metal, utilisez le dernier paquet compatible fourni dans v1.18.1 ou sur la page officielle des versions. Choisissez le binaire fourni le plus récent pour votre plateforme et votre backend, dans son paquet complet ; aucune compilation n’est nécessaire.

KataGo sur Windows

  • GPU NVIDIA : Privilégiez une compilation CUDA+cuDNN de v1.18.2, avec cuDNN 9.8.0 ou plus récent pour les réseaux Transformer. Une compilation TensorRT de v1.18.1 est une alternative si son environnement TensorRT distinct et compatible est déjà installé.
  • GPU AMD : Utilisez le binaire OpenCL fourni le plus récent depuis la page officielle des versions.
  • CPU uniquement : Utilisez le binaire Eigen fourni le plus récent ; privilégiez la compilation AVX2 si votre CPU la prend en charge.

Extrayez le zip dans un dossier dont vous vous souviendrez, comme C:\KataGo.

KataGo sur macOS

KataGo fonctionne très bien sur tous les Mac modernes, avec des différences importantes entre Apple Silicon et Intel.

Apple Silicon (M1/M2/M3/M4) : Utilisez le binaire macOS fourni le plus récent compatible avec KataGo v1.18.1, avec le backend Metal pour de meilleures performances. Installez via Homebrew :

brew install katago

Si vous n’utilisez pas Homebrew, téléchargez le binaire macOS fourni le plus récent depuis la page officielle des versions, puis placez katago dans un répertoire de votre PATH (p. ex. /usr/local/bin/ sur Mac Intel, ou /opt/homebrew/bin/ sur Apple Silicon).

Pour vérifier le binaire et le backend Metal, exécutez katago version dans le terminal — il devrait indiquer la version téléchargée et afficher Metal comme backend détecté.

Mac Intel : Utilisez le binaire macOS fourni le plus récent avec le backend OpenCL depuis la page officielle des versions.

Dépannage Homebrew : Si brew install katago échoue, assurez-vous que les Xcode Command Line Tools sont installés (xcode-select --install). En cas d’erreur de permissions, exécutez sudo chown -R $(whoami) /usr/local/share/man/man8 ou installez dans un répertoire vous appartenant.

Installation manuelle (sans Homebrew) : Téléchargez le binaire macOS fourni le plus récent depuis la page des versions de KataGo. Extrayez-le et placez katago dans un répertoire de votre PATH (p. ex. /usr/local/bin/ sur Mac Intel, ou /opt/homebrew/bin/ sur Apple Silicon). Rendez-le ensuite exécutable :

chmod +x /opt/homebrew/bin/katago   # Apple Silicon — ou /usr/local/bin/katago sur Intel

Note sur Gatekeeper : Lors de la première exécution d’un binaire téléchargé manuellement, macOS peut le bloquer. Allez dans Réglages Système > Confidentialité et Sécurité et cliquez sur Ouvrir quand même à côté du message bloqué. Vous n’aurez à le faire qu’une seule fois.

KataGo sur Linux

  • GPU NVIDIA : Privilégiez une compilation CUDA+cuDNN de v1.18.2, avec cuDNN 9.8.0 ou plus récent pour les réseaux Transformer. Une compilation TensorRT de v1.18.1 est une alternative si son environnement TensorRT distinct et compatible est déjà installé.
  • GPU AMD : Utilisez le binaire OpenCL fourni le plus récent depuis la page officielle des versions.
  • CPU uniquement : Utilisez le binaire Eigen fourni le plus récent ; privilégiez la compilation AVX2 si votre CPU la prend en charge.

Rendez le binaire exécutable avec chmod +x katago et placez-le dans un répertoire comme ~/katago.

Versions actuelles de KataGo et réseaux Transformer

KataGo 1.17.0 a ajouté la prise en charge des réseaux neuronaux Transformer au moteur C++ sur tous les principaux backends. Ces réseaux sont généralement bien plus forts à budget de calcul égal, mais ils utilisent la version de modèle 17 et ne se chargeront pas dans un moteur antérieur à KataGo 1.17.

La liste officielle des versions propose actuellement v1.18.2 pour CUDA et v1.18.1 pour les autres backends mentionnés (vérifié le 13 octobre 2026). Avant de télécharger, vérifiez le paquet et les exigences de son environnement d’exécution pour votre système et votre matériel. Extrayez l’archive complète dans un nouveau dossier au lieu de mélanger un nouvel exécutable avec d’anciennes DLL.

Tous les principaux backends peuvent exécuter des réseaux Transformer. OpenCL est largement compatible, mais sensiblement plus lent avec ces réseaux. Sur NVIDIA, privilégiez CUDA+cuDNN avec cuDNN 9.8.0 ou plus récent. TensorRT est une alternative qui exige son propre environnement compatible et peut prendre plus de temps au premier démarrage. Les paquets Homebrew peuvent être en retard sur les versions officielles : vérifiez katago version et les détails du paquet avant de charger un réseau Transformer.

Étape 2 : Télécharger un Réseau de Neurones

KataGo a besoin d’un fichier de réseau neuronal .bin.gz (le « cerveau » qui évalue les positions) :

  • Téléchargez le bon fichier : Sur la page officielle des réseaux KataGo, cliquez sur Network File. Ne téléchargez pas Raw Checkpoint : il est destiné à l’entraînement, pas à StoneBase.
  • Utilisez un réseau Transformer : Choisissez un réseau Transformer sur la page officielle des réseaux KataGo et assurez-vous que votre binaire KataGo est la dernière version fournie pour votre backend.
  • Adaptez le réseau à votre matériel : Commencez avec un réseau plus petit sur CPU ou GPU modeste. Les réseaux plus grands demandent davantage de RAM/VRAM et peuvent réduire le nombre de visites par seconde ; testez donc une position avant de choisir un modèle plus grand.

Enregistrez le fichier de réseau dans le même dossier que votre binaire KataGo.

Étape 3 : Configurer le Fichier de Configuration

KataGo utilise un fichier de configuration qui contrôle son comportement. Des exemples de configuration sont inclus dans le téléchargement de KataGo.

Important : StoneBase utilise le mode moteur d’analyse de KataGo, pas le mode GTP. Assurez-vous d’utiliser un fichier de configuration d’analyse (par ex., analysis_example.cfg), pas une configuration GTP (par ex., default_gtp.cfg). L’utilisation du mauvais format de configuration empêchera KataGo de démarrer correctement.

Si vous n’êtes pas sûr de la configuration à utiliser, StoneBase peut en fournir une. Dans la page des paramètres du moteur, cliquez sur Télécharger un exemple de configuration d’analyse KataGo pour obtenir un modèle prêt à l’emploi.

Paramètres clés à vérifier :

  • numSearchThreads : Threads que KataGo utilise pour la recherche. Commencez avec 1-2 pour la plupart des GPU.
  • maxVisits : Nombre maximum de positions à évaluer par coup. 500-1000 est un bon point de départ.

Pour la plupart des utilisateurs, la configuration d’analyse par défaut fonctionne bien dès le départ.

Étape 4 : Installer StoneBase

StoneBase est l’application de bureau gratuite qui pilote KataGo et vous offre une interface de révision complète. Téléchargez la dernière version depuis la page des versions GitHub et choisissez l’installateur pour votre plateforme :

  • Windows : Téléchargez StoneBase-X.Y.Z.msi, double-cliquez, suivez l’assistant.
  • macOS : Téléchargez StoneBase-X.Y.Z.dmg, glissez StoneBase dans Applications. Au premier lancement, macOS peut bloquer l’application — allez dans Réglages Système > Confidentialité et Sécurité et cliquez sur Ouvrir quand même.
  • Linux : Téléchargez stonebase_X.Y.Z_amd64.deb et installez avec sudo dpkg -i stonebase_X.Y.Z_amd64.deb.

Étape 5 : Configurer KataGo dans StoneBase

Ouvrez StoneBase et allez dans Paramètres. Dans la section KataGo, configurez :

  1. Chemin du binaire KataGo : Pointez vers l’exécutable katago de l’étape 1.
  2. Chemin du réseau de neurones : Pointez vers le fichier réseau .bin.gz de l’étape 2.
  3. Chemin du fichier de configuration : Pointez vers la configuration d’analyse .cfg de l’étape 3. Si vous n’en avez pas encore, cliquez sur Télécharger un exemple de configuration d’analyse KataGo dans la page des paramètres pour obtenir un modèle prêt à l’emploi.

Paramètres du moteur StoneBase montrant le chemin du binaire KataGo, le fichier de configuration et le statut du moteur

Cliquez sur Enregistrer et StoneBase vérifiera la connexion. Si tout est correctement configuré, vous verrez un message de confirmation.

Vous pouvez également affiner les paramètres d’analyse (visites maximales, threads, variations) sous l’onglet Analyse :

Paramètres d’analyse StoneBase avec le nombre de visites, les threads et les paramètres de variation

Étape 6 : Analyser Votre Première Partie

Une fois KataGo configuré :

  1. Importez un fichier SGF ou sélectionnez une partie depuis votre bibliothèque.
  2. Cliquez sur le bouton Analyser dans la barre d’outils.
  3. KataGo évaluera chaque coup, affichant :
    • Le taux de victoire : la probabilité de gagner pour chaque joueur
    • L’estimation de score : la différence de score projetée
    • Les coups candidats : les meilleures suggestions de l’IA avec leurs évaluations
    • La variation principale : la séquence de jeu attendue

Naviguez dans la partie pour voir comment l’évaluation change à chaque coup. Les grosses chutes du taux de victoire mettent en évidence vos plus grandes erreurs — ce sont les positions qui méritent d’être étudiées le plus attentivement.

Nouveau dans l’analyse IA ? Lisez notre court guide sur l’interprétation du taux de victoire et de l’estimation de score de KataGo avant de tirer des conclusions à partir des chiffres — interpréter une variation de 5 % comme une « bévue » est un piège courant chez les débutants.

Dépannage

KataGo ne démarre pas : Assurez-vous que le chemin du binaire pointe vers l’exécutable katago (pas le dossier). Sur macOS/Linux, vous devrez peut-être chmod +x katago.

L’analyse est très lente : Si vous utilisez le CPU, l’analyse sera considérablement plus lente. Choisissez un réseau plus petit sur la page officielle des réseaux, ou utilisez un GPU.

Erreur « Impossible de charger le réseau de neurones » : Vérifiez le chemin du fichier réseau et que sa version correspond à votre binaire KataGo installé. Les réseaux Transformer nécessitent KataGo 1.17 ou plus récent ; utilisez donc le binaire le plus récent fourni pour votre backend.

Estimations de score erronées : Si les taux de victoire et les scores semblent erronés, vérifiez que le paramètre de règles pour votre partie correspond aux règles sous lesquelles elle a été réellement jouée. Les règles japonaises et chinoises peuvent produire des évaluations différentes pour la même position. Vous pouvez configurer les règles par partie dans les paramètres de partie de StoneBase.

Questions Fréquentes

KataGo fonctionne-t-il sur Mac ?

Oui. Sur les Mac Apple Silicon (M1/M2/M3/M4), le binaire macOS fourni le plus récent fonctionne sur le backend Metal et est très rapide — installable avec brew install katago. Sur les Mac Intel, utilisez le binaire macOS fourni le plus récent avec le backend OpenCL.

Ai-je besoin d’un GPU pour faire fonctionner KataGo ?

Non, KataGo fonctionne sur CPU avec le backend Eigen, mais l’analyse sera considérablement plus lente. Tout GPU NVIDIA, AMD ou Apple Silicon moderne vous donnera une grande accélération — pour une révision sérieuse, un GPU est fortement recommandé.

Comment mettre à jour KataGo ?

Téléchargez le binaire le plus récent fourni pour votre backend depuis la page des versions de KataGo, puis remplacez l’ensemble du paquet extrait, pas seulement le binaire katago. Les configurations et réseaux conventionnels existants restent souvent utilisables, mais les réseaux Transformer nécessitent KataGo 1.17 ou plus récent. Vérifiez les notes de version et testez la configuration avant de supprimer votre installation fonctionnelle.

KataGo est-il gratuit ?

Oui, KataGo est entièrement open-source et gratuit à utiliser. StoneBase est également gratuit à télécharger — un niveau Pro débloque l’analyse par lots et d’autres fonctionnalités avancées, mais la révision de partie individuelle avec KataGo est gratuite pour toujours.

Quel réseau KataGo devrais-je utiliser ?

Commencez avec un Network File .bin.gz depuis la page officielle des réseaux KataGo. Pour bénéficier de la force des modèles Transformer, utilisez un réseau Transformer de cette page avec le binaire KataGo le plus récent fourni pour votre backend. Choisissez un réseau plus petit sur CPU ou GPU modeste, puis mesurez sa vitesse avant de passer à un modèle plus grand.

KataGo vs Leela Zero : quel est le meilleur pour la révision de partie ?

KataGo est activement maintenu, prend en charge l’estimation de score (pas seulement le taux de victoire), gère différents ensembles de règles (japonaises/chinoises/coréennes), et est généralement considéré comme plus fort que Leela Zero aujourd’hui. Pour la révision moderne de parties de Go, KataGo est le choix recommandé.

Puis-je utiliser KataGo en ligne sans l’installer ?

StoneBase est conçu comme une application de bureau — vos parties et analyses restent privées sur votre machine. Nous explorons l’analyse KataGo dans le cloud pour l’avenir, mais ce n’est pas encore disponible.

En attendant, l’installation est plus simple que la plupart des gens ne le pensent : ce guide vous accompagne à chaque étape, et une fois configuré, vous obtenez une analyse IA illimitée et gratuite avec une confidentialité totale. Si vous avez déjà un GPU, l’application de bureau est généralement plus rapide que toute option web puisqu’il n’y a pas de latence réseau.

Il existe des services web tiers comme Online KataGo ou AI Sensei qui proposent une analyse KataGo dans le navigateur sans installation — mais ils n’offrent pas la gestion de bibliothèque, la recherche de positions et les garanties de confidentialité locale de StoneBase.

Et Ensuite ?

Une fois KataGo opérationnel, vous pouvez :

  • Réviser des parties individuelles pour trouver vos erreurs et opportunités manquées
  • Analyser par lots toute votre bibliothèque (fonctionnalité Pro) pour obtenir des évaluations IA sur toutes vos parties à la fois
  • Explorer des variations en plaçant des pierres et en voyant comment KataGo évalue différentes continuations

La combinaison de votre propre capacité de lecture et de l’évaluation surhumaine de KataGo est le moyen le plus rapide d’identifier les faiblesses de votre jeu et de progresser.

Articles Connexes

Prêt à analyser avec l'IA ?

Si vous n'avez pas encore configuré KataGo, consultez notre guide d'installation complet de KataGo — il couvre l'installation sur Windows, Mac et Linux en quelques minutes.