Tutoriel Paperclip : comment installer et utiliser Paperclip

L'IA dépasse désormais le cadre des chatbots. Avec OpenAI's Dots, Meta's Muse et Grok Bot, nous voyons émerger une nouvelle façon d'utiliser l'IA au travail et dans notre quotidien. 

Plutôt que de jongler entre différents outils et de tout gérer nous-mêmes, nous pouvons confier une tâche à un assistant IA, le laisser agir à travers nos applications et intervenir lorsqu'il a besoin de notre validation.

Et si l'on allait plus loin en créant toute une entreprise d'agents IA ?

C'est précisément l'objectif de Paperclip. Il s'agit d'une plateforme open source où vous pouvez créer une organisation, recruter des agents IA pour différents rôles, leur fixer des objectifs et piloter leur travail depuis un tableau de bord unique.

Dans ce guide, je vous montre comment installer Paperclip sous Windows en utilisant Claude Code avec MiMo-V2.6-Pro à la place d'un abonnement Anthropic. Je partage aussi comment je m'en suis servi pour créer une petite équipe d'IA autour d'un objectif simple : créer un bot de trading.

Qu'est-ce que Paperclip ?

Paperclip est une plateforme d'orchestration open source pour agents IA. Imaginez que vous dirigiez une petite entreprise où vos employés sont des agents IA, chacun avec ses rôles, responsabilités et tâches.

Elle agit comme une tour de contrôle centrale, gérant vos agents, projets, attributions de tâches, budgets et validations. Le travail effectif est exécuté par des environnements d'agents comme Claude Code, Codex, Cursor et Gemini CLI.

Comment fonctionne Paperclip

Vous commencez par créer une organisation, définir son objectif et configurer votre premier agent. 

Ensuite, les agents peuvent élaborer des plans de projet, les décomposer en tâches plus petites et déléguer en fonction de leur hiérarchie de rattachement.

En arrière-plan, Paperclip utilise des adaptateurs d'agents pour se connecter à différents outils d'IA et un système de heartbeat pour exécuter automatiquement les agents. 

Lorsqu'un agent reçoit une tâche ou que son heartbeat planifié se déclenche, il se réveille, vérifie ses attributions via l'API de Paperclip, exécute le travail, publie des mises à jour puis s'arrête jusqu'à la prochaine exécution.

Par exemple, mon projet de bot de trading comptait trois agents :

• Chief of Staff : planifie le projet, coordonne l'équipe et délègue les tâches.
• ML Quant Researcher : développe des stratégies de trading, entraîne des modèles et lance des backtests.
• Trading Systems Engineer : conçoit l'infrastructure de trading, le moteur d'exécution et les contrôles de risque.

Au lieu de gérer trois sessions de code distinctes, je peux suivre toute l'équipe depuis un seul tableau de bord. 

Paperclip suit l'activité des agents, les journaux d'exécution et les coûts, tandis que les contrôles de validation me permettent de réviser les décisions importantes avant que les agents n'avancent.

Fonctionnalités clés de Paperclip

Voici quelques fonctionnalités qui rendent Paperclip intéressant :

• Orchestration multi-agents : créez des équipes complètes d'agents IA avec rôles définis, hiérarchies et objectifs partagés.
• Agents autonomes : les agents planifient, délèguent, collaborent et poursuivent leur travail avec un minimum d'intervention humaine, dans le cadre de leurs autorisations.
• Planification et automatisation : programmez des agents pour s'exécuter automatiquement ou déclenchez-les à l'arrivée de nouvelles tâches via le système de heartbeat de Paperclip.
• Multiplicité d'outils IA : connectez Claude Code, Codex, OpenCode et d'autres environnements d'agents pris en charge.
• Tableau de bord central : gérez agents, projets, tâches, journaux d'exécution et dépenses à partir d'un seul endroit.
• Budgets et validations : définissez des plafonds de dépenses, validez les nouvelles embauches d'agents et révisez les décisions importantes avant qu'ils n'avancent.

Premiers pas avec Paperclip

Nous allons commencer par installer Node.js et Claude Code sous Windows, configurer Claude Code pour utiliser MiMo-V2.6-Pro, puis installer Paperclip pour créer notre première organisation pilotée par l'IA.

1. Installer Node.js

Téléchargez d'abord la version LTS de Node.js pour Windows depuis le site officiel. Paperclip nécessite Node.js 24.11.0 ou plus récent.

Lancez l'installateur et conservez les options par défaut. Une fois l'installation terminée, ouvrez une nouvelle fenêtre PowerShell et exécutez :

node -v
npm -v
npx -v

Si les trois commandes renvoient des numéros de version et que Node.js est au moins en v24.11.0, nous pouvons installer Claude Code.

2. Installer et configurer Claude Code

Ensuite, nous devons installer Claude Code et le connecter à MiMo-V2.6-Pro. Claude Code servira de harnais d'agent, tandis que MiMo assurera le traitement IA.

Installez d'abord Git for Windows si ce n'est pas déjà fait. C'est recommandé pour les outils basés sur Bash de Claude Code.

Ouvrez PowerShell et installez Claude Code via l'installateur officiel Windows :

irm https://claude.ai/install.ps1 | iex

Vérifiez que tout fonctionne :

claude --version

Normalement, Claude Code se connecte aux modèles d'Anthropic. 

Dans mon cas, je disposais déjà d'un MiMo Token Plan et je voulais utiliser MiMo-V2.6-Pro sans acheter d'abonnement Claude.

Configurer Claude Code pour utiliser MiMo

Créez d'abord le répertoire de configuration de Claude Code :

New-Item -ItemType Directory -Force "$HOME\.claude"

Ouvrez le fichier de paramètres :

notepad "$HOME\.claude\settings.json"

Ajoutez la configuration suivante :

{
  "env": {
    "ANTHROPIC_BASE_URL": "YOUR_TOKEN_PLAN_BASE_URL",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MIMO_API_KEY",
    "ANTHROPIC_MODEL": "mimo-v2.6-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "mimo-v2.6-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "mimo-v2.6-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mimo-v2.6-pro"
  }
}

Remplacez YOUR_TOKEN_PLAN_BASE_URL et YOUR_MIMO_API_KEY par l'endpoint et la clé d'API depuis votre tableau de bord MiMo Token Plan. 

Si vous avez déjà un fichier de paramètres, fusionnez ces valeurs avec la configuration existante plutôt que de tout écraser.

Ensuite, ouvrez la configuration d'onboarding de Claude Code :

notepad "$HOME\.claude.json"

Si le fichier est nouveau, ajoutez :

{
  "hasCompletedOnboarding": true
}

S'il existe déjà, ajoutez ou mettez à jour cette propriété sans supprimer vos autres paramètres. Cela permet d'ignorer l'onboarding standard de Claude Code lorsque vous utilisez MiMo.

Enregistrez les deux fichiers, puis fermez et rouvrez PowerShell.

Tester la connexion

Lancez une invite simple pour vérifier que Claude Code utilise MiMo :

claude -p "Hey! Introduce yourself in one sentence."

Si tout est correctement configuré, vous devriez recevoir une réponse. Vous pouvez également lancer claude en mode interactif et exécuter /status pour vérifier la configuration du modèle.

Nous avons maintenant Claude Code opérationnel avec MiMo-V2.6-Pro et pouvons passer à Paperclip.

3. Installer Paperclip

L'installation de Paperclip est assez simple. Puisque Node.js est déjà installé, nous pouvons utiliser npx pour télécharger et démarrer Paperclip sans l'installer globalement.

Ouvrez une fenêtre PowerShell standard (pas en administrateur) et exécutez :

npx paperclipai onboard --yes

Cette commande télécharge Paperclip, crée la configuration locale, initialise une base PostgreSQL embarquée et lance le serveur.

Une fois démarré, ouvrez l'adresse suivante dans votre navigateur si la page d'onboarding ne s'ouvre pas automatiquement :

http://localhost:3100

Nous sommes prêts à créer notre première organisation, connecter Claude Code comme harnais d'agent et commencer à constituer notre équipe d'IA.

Pour relancer Paperclip ultérieurement, utilisez :

npx paperclipai run

Laissez le terminal ouvert pendant l'utilisation de cette configuration locale.

4. Onboarder Paperclip

Maintenant que Paperclip fonctionne, nous pouvons créer notre première organisation IA, définir son CEO et la connecter à MiMo-V2.6-Pro.

La première étape consiste à nommer votre organisation. Pour mon test, j'ai utilisé DataCamp.

Cliquez sur Continue. Paperclip vous demande ensuite de nommer votre premier agent. Il s'agira de votre CEO, chargé de planifier les projets, créer des tâches et déléguer le travail aux autres agents.

Sélectionnez ensuite un adaptateur d'agent. Paperclip prend en charge plusieurs options, dont Claude Code, Codex, Cursor, Gemini CLI et OpenCode.

Pour ce guide, choisissez Claude Code.

Puisque nous avons déjà configuré Claude Code pour utiliser MiMo, notre chaîne ressemble à ceci :

Paperclip -> Claude Code -> MiMo-V2.6-Pro

Pendant l'onboarding, Paperclip vous demande aussi sur quoi votre organisation doit travailler. Pour mon premier projet, j'ai simplement indiqué :

« Build the trading bot »

5. Créer votre premier projet

Une fois l'onboarding terminé, Paperclip m'a envoyé directement sur mon projet de bot de trading. 

Mon Chief of Staff a commencé par poser des questions sur ce que je voulais réaliser, plutôt que de se jeter immédiatement dans le code.

Après mes réponses, il a réuni un plan de projet et proposé d'embaucher deux agents supplémentaires : un ML Quant Researcher et un Trading Systems Engineer.

Il a également découpé le projet en tâches plus petites :

• Mettre en place le dépôt et le pipeline de données.
• Construire un modèle ML de base et lancer des backtests.
• Développer le moteur d'exécution en paper trading.
• Ajouter des contrôles de risque de base.
• Lancer un essai en paper trading.

Avant d'aller plus loin, Paperclip m'a présenté le plan et proposé trois options : Approve, Request Revision, ou Reject. C'est un élément clé de la plateforme : vous conservez le contrôle sur ce que vos agents sont autorisés à faire.

J'ai approuvé le plan et Paperclip a tout mis en musique. Il a créé les agents supplémentaires et commencé à attribuer des tâches selon leurs rôles.

Ce que j'ai le plus apprécié, c'est de ne pas avoir à créer chaque agent, écrire des prompts individuels ou répartir le travail à la main. 

J'ai simplement expliqué ce que je voulais construire, répondu à quelques questions et approuvé le plan proposé. Paperclip s'est chargé de la coordination du projet.

6. Tester Paperclip

Une fois mon projet de bot de trading en route, j'ai ouvert le tableau de bord Paperclip pour suivre l'avancement. C'est là que vous pouvez surveiller vos agents, suivre les tâches, consulter l'activité récente et garder un œil sur les coûts.

Je pouvais également ouvrir la page Agents pour voir toute mon équipe IA et l'activité de chacun. 

Mon Chief of Staff et mon ML Quant Researcher étaient inactifs, tandis que le Trading Systems Engineer travaillait activement sur le projet.

La page Agents affiche aussi la structure hiérarchique, le harnais d'agent utilisé par chacun, et si un agent est en cours d'exécution, au repos, en pause ou en erreur.

C'est sans doute la partie que j'ai trouvée la plus utile. Plutôt que de garder plusieurs terminaux ouverts et de vérifier sans cesse l'activité de chaque agent, je gère tout au même endroit. 

Je vois quelles tâches avancent, lesquelles sont bloquées, combien j'ai dépensé et si quelque chose requiert mon approbation.

La sensation est vraiment celle de manager une petite équipe, plutôt que de piloter des agents IA isolés. Je fixe un objectif, je suis l'avancement et j'interviens au besoin.

Comment les utilisateurs se servent-ils de Paperclip ?

Paperclip ne sert pas qu'au code, loin de là. 

De la gestion d'une petite entreprise à la coordination d'équipes d'IA entrières, voici cinq exemples intéressants trouvés sur Reddit et des blogs de développeurs.

1. Gérer une entreprise en solo

Un fondateur utilise 16 agents IA pour la prospection, les emails à froid, les mises à jour CRM, le référencement et la publication de billets de blog, tout en conservant un emploi à temps plein.

2. Gérer une maison d'édition IA

Un trader à la retraite a construit une maison d'édition propulsée par l'IA où les agents gèrent la recherche, la rédaction et le SEO. Ses principaux enjeux : maîtriser les coûts et vérifier l'exactitude des articles générés.

3. Piloter des agents IA via Telegram

Un développeur a connecté Paperclip avec Hermes pour gérer une startup de neuf agents via Telegram. Les agents s'occupent du design produit, des estimations de coûts, des demandes de subventions et des comptes rendus quotidiens.

4. Lancer une startup IA dans la finance

Un autre développeur a créé une équipe IA pour une startup financière avec un CEO, un CTO, des ingénieurs et des agents marketing travaillant sur des pipelines de données, l'analyse de sentiment et l'outreach.

5. Gérer une activité de contenu avec 13 agents

Le développeur Felipe Fontoura a bâti une organisation de 13 agents pour le SEO, la création de contenus, les scripts vidéo et les tunnels de vente. Le système fonctionnait, mais la relecture et la publication exigeaient encore son implication.

Les utilisateurs dépassent l'étape de multiples instances Claude Code qui opèrent en silos. 

Avec Paperclip, ils créent des équipes de 10 agents ou plus qui communiquent, suivent une hiérarchie claire, délèguent les tâches et se relisent entre eux. 

Au lieu de gérer chaque agent vous-même, vous fixez un objectif à l'équipe et la laissez coordonner le travail, tout en supervisant l'avancement et en validant les décisions importantes.

Conclusion

Dans ce guide, nous n'avons fait qu'effleurer le potentiel de Paperclip.

Je n'ai constitué qu'une petite équipe de trois agents, mais vous pouvez aller beaucoup plus loin : créer des départements entiers, programmer des tâches, définir des budgets et ajouter des agents qui se relisent mutuellement.

Paperclip n'est pas une expérimentation de dernière minute : le projet existe depuis un moment et s'appuie sur une communauté open source grandissante. 

Avec la montée en puissance des agents IA, piloter plusieurs équipes depuis un tableau de bord unique devient beaucoup plus intéressant.

C'est, à mon sens, la direction prise par l'IA.

Au lieu d'ouvrir dix sessions Claude Code et de tout gérer à la main, nous aurons de plus en plus un point central pour coordonner des centaines, voire des milliers, de tâches entre des agents spécialisés. 

Nous donnons un objectif à l'équipe, les agents se répartissent le travail, communiquent entre eux et nous sollicitent quand c'est nécessaire.

Bien sûr, gérer des agents à cette échelle comporte des défis, notamment en termes de coûts, de fiabilité et de supervision humaine. 

Mais Paperclip offre un moyen concret d'expérimenter cette nouvelle façon de travailler dès aujourd'hui.