botpress/botpress : le dépôt qui héberge les intégrations et les devtools de Botpress Cloud

Un dépôt de hub, pas un moteur de chatbot

Le malentendu le plus courant autour de botpress/botpress vient du nom. Le dépôt ne contient pas le runtime d'un chatbot auto-hébergé. Il regroupe quatre ensembles : les intégrations publiques publiées sur le Botpress Hub, les devtools de Botpress Cloud (CLI, SDK, client API), des exemples de bots écrits uniquement avec le SDK et le CLI, et un dossier de plugins encore vide. Le README précise que pour tout problème lié à Botpress v12 en installation locale, il faut consulter le dépôt botpress/v12. La frontière est donc nette : ici, on construit des briques qui s'exécutent dans Botpress Cloud, pas une instance que l'on héberge soi-même. Le public visé est celui qui écrit du TypeScript et veut soit connecter un service tiers à la plateforme, soit piloter des bots de façon programmatique. Le dépôt est sous licence MIT, ce qui couvre l'ensemble des paquets qu'il contient, et le README indique que toute contribution y est publiée sous cette même licence.

Ce que fait vraiment le CLI, étape par étape

L'unité de travail est l'intégration. Le README décrit la boucle complète. On installe d'abord l'outil globalement, avec npm install -g @botpress/cli, ou yarn global add @botpress/cli, ou pnpm install -g @botpress/cli. Ensuite, dans n'importe quel répertoire, bp init génère une intégration à partir d'un des gabarits proposés. Le README insiste sur un point pratique : cette commande peut être lancée dans le répertoire et le dépôt git de votre choix, il n'est pas nécessaire de forker botpress/botpress pour créer une intégration. Le travail se répartit alors entre deux fichiers, integration.definition.ts pour la définition et src/index.ts pour l'implémentation. Le déploiement se fait avec bp deploy, qui pousse la version courante vers votre workspace et la rend disponible à tous vos bots. Si la version existe déjà, elle est mise à jour, sinon une nouvelle version est créée. Par défaut, une intégration reste privée au workspace où elle a été déployée. La commande bp deploy --visibility public la rend visible pour tous les utilisateurs de Botpress sur le Hub, avec une conséquence à retenir : une fois une version publique, elle ne peut plus être modifiée.

La règle de publication qui change la façon de versionner

Cette immuabilité des versions publiques est la contrainte de conception la plus lourde du modèle, et elle n'est pas un détail. Elle signifie que la correction d'un bug visible par la communauté passe obligatoirement par une nouvelle version, jamais par une réécriture de l'existante. Le cycle bp init, édition, bp deploy, test, puis bp deploy --visibility public ne se rejoue donc pas de la même manière selon qu'on est en privé ou en public. En privé, on itère sur place. En public, chaque changement est un nouvel artefact. Pour un mainteneur d'intégration, cela impose de traiter la première publication comme un engagement : le nom, la définition et le comportement exposés à ce moment-là resteront la référence de cette version. Le README ne décrit pas de mécanisme de dépréciation ni de politique de rétention des anciennes versions, et cette partie reste à vérifier dans la documentation en ligne plutôt que dans le dépôt lui-même.

Les bots as code : un usage assumé comme non recommandé

Le dossier /bots contient des exemples de bots écrits uniquement avec le client, le SDK et le CLI. Le README est direct sur leur statut : ce n'est pas la manière recommandée de construire des bots et cela ne remplace en rien Botpress Studio. L'argument avancé est différent : ces exemples servent aux développeurs expérimentés qui veulent une approche plus programmatique. Ils servent aussi en interne, puisque le Studio et le SDK s'appuient sur les mêmes primitives sous-jacentes. C'est une position honnête, et elle mérite d'être prise au sérieux plutôt que contournée. Si votre besoin est de livrer un assistant conversationnel à une équipe non technique, l'approche par code ajoute une couche de maintenance sans bénéfice évident. Si votre besoin est de versionner un comportement, de le tester ou de le générer, l'intérêt devient réel. La documentation ne détaille pas ce que l'on perd fonctionnellement en abandonnant le Studio, et c'est probablement la première question à poser avant de s'engager sur cette voie.

Intégrations, SDK et client : trois paquets, trois rôles

Les devtools se répartissent en trois paquets npm. @botpress/cli sert à construire, déployer et gérer bots, intégrations et plugins. @botpress/client fournit des clients typés pour consommer les API Botpress. @botpress/sdk est le SDK utilisé pour construire les intégrations. Le README présente ces paquets dans un tableau, avec des liens vers la documentation pour le CLI et des cellules vides pour les deux autres, ce qui indique que la documentation de référence de ces paquets vit ailleurs, sur le site Botpress, et non dans le dépôt. Les intégrations publiques maintenues par Botpress se trouvent dans /integrations, et c'est aussi là que la communauté est invitée à contribuer ou à publier les siennes. Le dossier /plugins, lui, est annoncé comme à venir : il ne faut donc rien en attendre pour l'instant. Cette répartition implique une dépendance à l'écosystème npm pour l'outillage, et à la plateforme Botpress Cloud pour l'exécution.

Construire le dépôt localement : ce que demandent les prérequis

Pour travailler sur le dépôt lui-même plutôt que sur une intégration, le README liste git, node et pnpm comme prérequis, avec une mention spécifique pour Windows : le Microsoft Visual C++ Redistributable pour Visual Studio 2015-2022. La séquence est classique : git clone https://github.com/botpress/botpress.git, cd botpress, pnpm install, pnpm run build, puis pnpm run check pour les vérifications. Le choix de pnpm est cohérent avec un monorepo TypeScript de cette taille, mais il faut noter que le README ne donne pas de version minimale de Node ni de pnpm. Sur une machine où plusieurs versions de Node cohabitent, c'est le genre d'omission qui produit une erreur de build difficile à interpréter. À l'inverse, la commande bp init ne demande pas de cloner le dépôt : pour simplement écrire une intégration, la construction depuis les sources n'est pas nécessaire.

Maintenance, versions et alternatives

Les publications étiquetées les plus récentes visibles dans les métadonnées sont v12.30.9 (juin 2023), v12.30.8 (avril 2023) et v12.30.7 (février 2023). Le dépôt n'est pas archivé et le dernier push sur master est daté de septembre 2026, ce qui suggère une activité sur la branche principale sans publication étiquetée correspondante. Cette dissociation entre tags et commits est un point à éclaircir avant de dépendre du dépôt pour une intégration en production : les numéros v12.x renvoient à la lignée v12, alors que le contenu décrit dans le README concerne Botpress Cloud. Comme alternative, on peut citer LangChain, également listé dans les topics du dépôt. La différence d'approche est structurelle : LangChain est une bibliothèque que l'on assemble dans sa propre application, sans plateforme d'exécution ni hub d'intégrations imposés, alors que botpress/botpress suppose un compte Botpress Cloud et un cycle de déploiement via bp deploy. Choisir l'un ou l'autre revient largement à choisir entre héberger son orchestration et la déléguer. Sur le plan juridique, la licence MIT du dépôt est permissive, mais elle ne couvre que le code de ce dépôt : l'usage de Botpress Cloud relève de conditions distinctes, à examiner séparément.

Conclusion éditoriale

Ce dépôt s'adresse aux développeurs TypeScript qui veulent écrire ou publier une intégration pour Botpress Cloud, ou piloter des bots par code plutôt que par le Studio. Il ne convient pas à qui cherche un moteur de chatbot auto-hébergé : pour l'installation sur site, le README renvoie explicitement vers le dépôt botpress/v12. Avant d'adopter quoi que ce soit ici, vérifiez deux points : la date de la dernière publication étiquetée (v12.30.9, juin 2023) face au dernier push sur master, et la règle de publication des intégrations, puisqu'une version rendue publique via bp deploy --visibility public ne peut plus être modifiée.

Sources officielles

1. botpress/botpress on GitHub
2. License: MIT
3. Project website
4. README
5. Releases