Paddock : un sandbox pour agents IA auto-hébergé

À quoi sert Paddock, concrètement ?

Paddock donne à un agent IA un ordinateur Linux distinct sur un VPS que vous gérez. Cette « box » contient ses fichiers, ses outils et un bureau Ubuntu XFCE. L'agent peut lancer des commandes, construire une application puis l'ouvrir pour examiner le résultat. Vous pouvez garder cet espace ou créer un sandbox temporaire pour une seule mission.

Le site public présente un logiciel à déployer soi-même. Il faut donc installer le serveur avant de disposer d'un bureau utilisable. Paddock fournit l'environnement d'exécution ; l'agent et son modèle réalisent le travail demandé.

Tester du code et regarder l'application fonctionner

Docker fonctionne à l'intérieur des boxes grâce à Sysbox. Claude Code, Codex, OpenCode, Pi, Prime et Kimi sont préinstallés, avec une authentification à configurer pour le fournisseur retenu. La commande paddock prompt transmet une tâche à un agent. Le tableau de bord, la CLI, l'API HTTP et les SDK TypeScript/Python offrent plusieurs moyens de piloter ces environnements.

Pour vérifier une interface, ouvrez le bureau avec paddock desktop, lancez le programme via exec --desktop et enregistrez une image avec paddock screenshot. Cette boucle permet d'inspecter l'application produite, au-delà du seul texte généré.

Installer Paddock et exécuter un premier test

Le guide d'installation demande un VPS Ubuntu ou Debian, un accès root, une architecture amd64 ou arm64, les ports 80 et 443 ouverts et un nom d'hôte qui pointe vers le serveur. Créez le compte propriétaire avec le lien à usage unique affiché après installation. Installez ensuite la CLI sur votre poste et connectez-la au serveur.

Pour un projet Node préparé localement, le parcours suivant transfère les fichiers et lance les tests :

paddock new --type small --ttl 3600
paddock push current . --to /config/project
paddock exec current -- bash -lc 'cd /config/project && npm test'
paddock stop current

Lisez la sortie pour vérifier leur réussite. Les dépendances doivent être présentes ou téléchargées avec les autorisations réseau nécessaires. La dernière commande arrête la box après un snapshot du système de fichiers. Rapatriez les livrables avec pull avant de supprimer un environnement jetable. Le skill Paddock peut apprendre aux agents compatibles à utiliser la CLI.

Encadrer le réseau et les échanges de données

Choisissez allow-all, deny-all ou une liste de domaines et réseaux IPv4 autorisés. La valeur par défaut est allow-all : l'absence de réseau n'est pas automatique. Deny-all bloque les nouvelles connexions sortantes, tandis que les connexions existantes peuvent se terminer. Les métadonnées cloud restent bloquées.

Prévoyez les accès aux modèles, dépôts et registres de paquets indispensables. Héberger Paddock vous-même donne le contrôle du serveur d'exécution, mais les données envoyées à une API externe suivent aussi les conditions de ce fournisseur. Ces mécanismes ne constituent pas une promesse d'isolation absolue.

Conserver des fichiers et revenir en arrière

Les boxes peuvent être arrêtées, reprises, dupliquées par fork et restaurées. Les disques nommés sous /mnt survivent à la suppression d'une box. Ils conviennent aux caches ou ressources réutilisables.

Consultez les limites des snapshots : ils conservent le système de fichiers, sans la RAM, les processus actifs, /var/lib/docker ni les disques montés. Une sauvegarde séparée est nécessaire pour ces disques ; reprendre une box ne reprend pas un processus à son instruction précédente.

Licence et coût d'une installation réelle

Vérification du 29 octobre 2026 : Paddock est distribué sous licence MIT. Les pages officielles examinées n'affichent pas d'abonnement Paddock hébergé. Le VPS, le stockage et l'utilisation des modèles restent des dépenses distinctes selon les services choisis. Le nombre de boxes simultanées dépend des ressources de votre machine.

L'outil convient aux développeurs qui souhaitent contrôler le poste de travail de leurs agents et peuvent assurer l'administration Linux, les mises à jour et les sauvegardes.

Questions fréquentes

Paddock est-il gratuit et open source ?

Le code MIT est disponible sans abonnement logiciel dans les sources vérifiées. Cela ne finance pas l'hébergement ni les appels aux modèles.

Peut-on le piloter depuis Windows ou macOS ?

Oui, des installations de la CLI sont documentées pour les deux. Le serveur reste un déploiement Linux conforme aux prérequis.

Une box est-elle privée d'internet dès sa création ?

Non : allow-all est le réglage initial. Appliquez deny-all ou une liste autorisée selon la tâche.

Ressources officielles

• Dépôt du projet : code et références techniques.
• Versions et téléchargements : binaires disponibles et informations de version.