skip to content

Recherche
Syspirit
FR

#Paperclip : Montez votre entreprise d'agents IA en self-hosted !

6 minutes de lecture Karl Certa
#ia #agents #orchestration #automatisation #veille
Paperclip - Orchestration d'agents IA
Image générée par IA

Je ne suis pas du genre à bosser avec 15 agents IA en parallèle. D’habitude, un terminal Claude Code ouvert me suffit largement. Mais récemment, j’ai voulu tester : ouvrir plusieurs terminaux, chacun avec un agent sur une tâche différente du même projet. Le résultat ? Au bout de 20 minutes, je ne savais plus qui faisait quoi, les agents se marchaient dessus sur les mêmes fichiers, et j’ai perdu le fil. Bref, c’était le bazar.

C’est en cherchant une solution que je suis tombé sur Paperclip, un outil open-source avec plus de 26k stars sur GitHub. Le concept : orchestrer vos agents IA comme une vraie entreprise, avec un organigramme, des budgets, un système de tickets et de la gouvernance. Je l’ai testé, j’ai monté une équipe de 8 agents pour un side-project, et je vous raconte.

C’est quoi Paperclip ?

Le constat

Quand on essaie de faire bosser plusieurs agents IA ensemble, on se retrouve vite avec des problèmes : les agents ne savent pas ce que font les autres, ils n’ont aucune mémoire entre les sessions, et on n’a aucune visibilité sur combien ça coûte.

Le principe

Paperclip, c’est un serveur Node.js (TypeScript) avec une interface React qui permet de coordonner une équipe d’agents IA. Le projet est sous licence MIT, maintenu activement (v0.3.1, 3k5 forks, +350 PRs ouvertes), et la communauté grandit vite.

Le fonctionnement tient en 3 étapes :

  1. Définir un objectif pour votre “entreprise” IA
  2. Recruter l’équipe en créant des agents avec des rôles (CEO, CTO, développeurs, QA…)
  3. Lancer et superviser depuis un dashboard

Chaque agent a ses tâches assignées, son budget, et il sait exactement pourquoi il travaille. Plus de conflits, plus de contexte perdu entre les sessions. Et surtout, on peut mixer les IA dans la même équipe : un CEO sur Claude Code, un développeur sur Codex, un autre sur OpenClaw… Paperclip supporte aussi Cursor, Gemini, Bash et les webhooks HTTP.

Installation

La méthode rapide

npx paperclipai onboard --yes

Cette commande installe tout automatiquement, y compris la base de données embarquée (PGlite). Rien à configurer, l’interface est accessible sur http://localhost:3100.

Prérequis : Node.js 20+ et pnpm 9.15+.

En clonant le repo

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

Avec Docker Compose

Pour un setup plus sérieux avec PostgreSQL 17 :

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
 
export BETTER_AUTH_SECRET="votre_secret_ici"
export PAPERCLIP_PUBLIC_URL="http://localhost:3100"
 
docker-compose up -d

Ce que j’ai monté

Pour tester Paperclip concrètement, j’ai créé une “entreprise” pour Job-Ctrl, un projet de suivi de candidatures en Go et TypeScript. J’ai juste eu à définir l’objectif du projet et créer le CEO. Au départ, il m’a proposé de recruter un Founding Engineer et s’est mis au boulot avec. Ensuite, c’est moi qui lui ai demandé de monter une équipe complète : CTO, Tech Lead, développeurs, QA, etc. Il a créé tous les agents, leur a assigné des rôles et des tâches. Moi, en tant que “board”, je n’ai eu qu’à approuver les embauches.

Avec du recul, l’équipe est clairement trop grosse et probablement mal structurée pour un side-project de cette taille. 8 agents pour un tracker de candidatures, c’est overkill. Mais c’était le but : tester les limites de l’outil et voir ce qu’il permet de faire. Et sur ce point, ça donne un bon aperçu des possibilités.

L’interface

Voici à quoi ressemble l’organigramme de mon équipe dans Paperclip :

Organigramme Paperclip de mon équipe Job-Ctrl

Sur la gauche de l’interface, on retrouve la navigation : le dashboard, la boîte de réception, les issues (tickets), les goals (objectifs), le projet Job-Ctrl, et la liste de tous les agents avec leur statut en temps réel. On voit ici que 3 agents sont “live” (le CEO et le Tech Lead entre autres). En bas, les sections Org, Costs et Activity permettent de gérer l’organigramme, les budgets et le journal d’activité.

Au centre, c’est l’organigramme interactif avec la hiérarchie complète. Le CEO en haut, le CMO et le CTO en dessous, puis le QA Engineer, le Tech Lead et le Design Engineer sous le CTO, et enfin le Developer et le Founding Engineer sous le Tech Lead. Chaque carte affiche le rôle, le titre et le type d’agent (ici tous sur Claude).

L’équipe en détail

Chaque agent a son propre dossier de configuration dans le projet :

agents/
├── ceo/
│   ├── AGENTS.md      # Instructions générales
│   ├── SOUL.md        # Personnalité et posture
│   ├── HEARTBEAT.md   # Checklist d'exécution à chaque réveil
│   └── memory/        # Mémoire persistante
├── cto/
├── developer/
└── ...

Le SOUL.md du CEO, par exemple, définit sa façon de penser et de communiquer. Le HEARTBEAT.md est la checklist qu’il déroule à chaque réveil : lire son plan du jour, récupérer ses tâches, déléguer aux bons agents.

Comment ça fonctionne au quotidien

Le CEO se réveille à chaque “heartbeat” (un cycle planifié) et fait le tour : qu’est-ce qui est en cours, qu’est-ce qui bloque, qu’est-ce qu’il faut déléguer. Le CTO traduit les objectifs en tâches techniques et les assigne via le Tech Lead. Le Developer reçoit un ticket, code, teste, et soumet pour review. Le QA valide la qualité.

Quand un agent prend une tâche, personne d’autre ne peut la prendre. Pas de double travail, pas de conflits. Et chaque tâche porte l’historique complet de pourquoi elle existe, de l’objectif business jusqu’au ticket. Les agents ne partent pas dans tous les sens.

Au démarrage, Paperclip donne automatiquement à chaque agent toutes les infos dont il a besoin : qui il est, sur quelle entreprise il bosse, quelle tâche lui est assignée, et pourquoi il se réveille. Pas besoin de lui réexpliquer le contexte à chaque fois.

La roadmap

Le projet est encore jeune (v0.3.1), mais la suite est prometteuse :

  • ClipMart : une marketplace pour télécharger des templates d’entreprises IA pré-configurées. Un organigramme complet en un clic, c’est probablement la feature la plus attendue
  • Agents cloud : support de Cursor, e2b et d’autres agents distants
  • Système de plugins : pour ajouter des bases de connaissances, du tracing, des queues…
  • Configs simplifiées : rendre la mise en place des agents plus accessible
  • Meilleure documentation : en cours de refonte

Les limites

Quelques points à garder en tête quand même :

  • Le projet est encore en V1 : les docs sont en chantier et certaines features manquent encore
  • Ça dépend de vos agents : Paperclip orchestre, mais la qualité du résultat dépend des modèles utilisés derrière (Claude, Codex, etc.)
  • Ça consomme : faire tourner plusieurs agents, ça coûte en tokens et en compute

Conclusion

Pour moi qui n’avais jamais vraiment bossé avec plusieurs agents en même temps, Paperclip a changé la donne. On passe de “j’ouvre 5 terminaux en espérant qu’ils se marchent pas dessus” à quelque chose de structuré où chaque agent sait ce qu’il a à faire.

Open-source, self-hosted, licence MIT, 26k+ stars et une communauté active. Si vous commencez à jongler avec plusieurs agents IA, ça vaut clairement le coup d’œil !

Liens utiles :