# Pi : un agent de code open source pour le terminal

> Pi, harnais d'agent de code open source sous licence MIT : un agent dans le terminal qui fonctionne avec de nombreux modèles d'IA, passé en 1.0.

- Type : actu de l'IA
- Famille : Agents IA · Harnais d'agent de code
- Habitat : Terminal · TypeScript
- Niveau : intermédiaire
- Langage : TypeScript
- Licence : MIT
- Étoiles GitHub : 112049 (relevé le 3 octobre 2026)
- Source : https://github.com/earendil-works/pi
- Publié le : 3 octobre 2026
- Page : https://geekus.fr/projets/pi/

Pi est un harnais d'agent de code open source : un programme qui entoure un modèle d'IA pour lui permettre de lire des fichiers et d'exécuter des commandes, depuis le terminal. Il ne dépend pas d'un seul fournisseur de modèles et vient de passer en version 1.0, publiée le 1er octobre 2026. Voici ce qu'il contient, comment l'installer et ce qu'il faut savoir avant de le lancer.

## En bref

- Un agent de code qui se lance dans le terminal, sous licence MIT
- Une API unifiée pour plusieurs fournisseurs de modèles : OpenAI, Anthropic, Google
- Au programme de la 1.0 : support natif de MCP, chargement différé des outils, plein écran par défaut
- Aucun système de permissions intégré : Pi tourne avec les droits de l'utilisateur
- Pi Durable, un paquet expérimental, vise les tâches de longue durée

## Pi, un harnais d'agent de code open source

Un modèle d'IA, pris seul, ne fait que produire du texte ou des images. Le **harnais** regroupe tout ce qui l'entoure pour qu'il puisse accéder à des fichiers, exécuter des commandes ou faire des recherches sur Internet. Claude Code, par exemple, est un harnais limité aux modèles d'Anthropic, comme le rappelle l'article de Next consacré à la sortie de Pi 1.0.

Pi est l'un de ces harnais, mais sans cette limite. Selon Next, il est compatible avec plus de 1 500 modèles et variantes, et se présente comme une alternative à Claude Code ou à Codex. Ses auteurs le décrivent comme un harnais **minimal**, durci et extensible, que chacun peut adapter à sa façon. Le code est publié sous licence MIT.

## Comment fonctionne Pi

Le dépôt se présente comme une boîte à outils pour construire des agents : une API unifiée pour les modèles de langage, une boucle d'agent, une interface de terminal et un agent de code. Chaque brique est un paquet distinct, ce qui permet de les utiliser séparément. L'agent de code est lui-même décrit comme extensible : dans la démonstration de l'annonce, Pi écrit sa propre extension.

D'autres paquets complètent l'ensemble : un runtime d'application nommé chord, des contrats de télémétrie et Pi Durable, présenté plus bas. L'automatisation pour Slack et les outils de discussion relève d'un dépôt séparé, pi-chat.

- pi-coding-agent : l'agent de code interactif, en ligne de commande
- pi-agent-core : le moteur d'agent, avec appel d'outils et gestion de l'état
- pi-ai : une API unifiée pour plusieurs fournisseurs (OpenAI, Anthropic, Google et d'autres)
- pi-tui : une bibliothèque d'interface de terminal à rendu différentiel

## Changer de modèle et brancher des outils MCP avec Pi

Avec ce type de harnais, tu peux utiliser des modèles commerciaux ou à poids ouverts, y compris en local, et en changer en cours de route, d'après Next. Pi pousse l'idée plus loin avec les **modèles virtuels** définis par des extensions. La démonstration de l'annonce montre un modèle `router/auto` qui planifie avec Claude Opus puis implémente avec GPT 6 Luna, un modèle nommé Jev décidant du moment du changement. La commande `/session` détaille ensuite le coût par modèle et l'usage du cache.

Pi gère aussi MCP, un protocole qui sert à connecter des outils externes à un agent. Ce support passe par le mode « codemode » : dans l'annonce, Pi rédige un script qui résume une semaine de commits. Depuis la 0.99.2, les serveurs MCP ne sont plus listés dans la description de `codemode` et ne bloquent plus le premier prompt ; les scripts retrouvent leurs outils avec `searchTools()` et `describeNamespace()`.

## Installer Pi

L'annonce de la version 1.0 donne un script d'installation par système. Voici les deux commandes, telles que publiées. Les prérequis (version de Node, espace disque…) ne sont pas précisés dans les sources consultées.

Pour utiliser un modèle, la commande `/login` permet de se connecter à un fournisseur, et les clés d'API peuvent aussi être lues dans l'environnement. La documentation est sur le site du projet, et le README ajoute que tu peux aussi demander à l'agent de t'expliquer lui-même son fonctionnement.

```bash
curl -fsSL https://pi.dev/install.sh | sh
powershell -c "irm https://pi.dev/install.ps1 | iex"
```

## Où en est Pi : la version 1.0 et ses nouveautés

Selon l'annonce du 1er octobre 2026, des centaines de milliers de personnes utilisent Pi chaque semaine. La 1.0 rassemble des fonctions retenues après des mois de tests, et l'équipe précise que la liste de celles qui ont été écartées est bien plus longue. Elle suit de peu la 0.99.2 du 30 septembre et la 0.99.1 du 29 septembre, qui avait fait de GPT-6.1 Sol le modèle par défaut d'OpenAI Codex.

Chiffres relevés sur GitHub le 3 octobre 2026 : 111 975 étoiles, 14 203 copies du dépôt, 299 contributeurs et 261 tickets et demandes de fusion ouverts. Le dépôt a été créé le 9 août 2025 ; son code est écrit à 97 % en TypeScript et à 3 % en JavaScript.

- Plein écran par défaut ; le réglage `tuiMode` à `"regular"` rend le défilement habituel du terminal
- Codemode allégé : environ 40 % de jetons de prompt en moins, avec des erreurs qui indiquent au modèle comment s'en sortir
- Génération d'images dans codemode, avec `models.generateImages()` et les identifiants de la session
- Chargement différé des outils et messages système en cours de conversation
- Préchauffage du cache pour les modèles d'Anthropic et nouveau thème d'interface
- Connexion via Radius dans `/login`, authentification OAuth renforcée pour les serveurs MCP et démarrage discret avec `quietStartup: "header"`

## Pi Durable, pour les tâches de longue durée

Livré avec la 1.0, Pi Durable est un paquet expérimental. Le README le décrit comme un runtime de conversations, de tâches et de documents durables. L'équipe veut amener l'approche de Pi hors du terminal et de l'agent de code, avec des conversations et des tâches qui durent plus longtemps. Next rapporte qu'il peut résister à des pannes « catastrophiques ».

L'installation passe par npm, avec la commande donnée dans l'annonce :

```bash
npm install @earendil-works/pi-durable @earendil-works/pi-ai @earendil-works/chord
```

## Ce qu'il faut savoir avant d'utiliser Pi

Pi n'a **aucun système de permissions** intégré pour limiter l'accès aux fichiers, aux processus, au réseau ou aux identifiants. Il tourne avec les droits de l'utilisateur qui le lance. Pour poser des limites, la documentation propose trois pistes : l'extension Gondolin, qui envoie les outils intégrés dans une micro-machine virtuelle Linux locale, Docker, ou OpenShell, un bac à sable à politique contrôlée.

Côté contribution, les nouveaux tickets et demandes de fusion issus de nouveaux contributeurs sont fermés automatiquement par défaut, puis relus chaque jour par les mainteneurs. Le README décrit aussi des mesures sur les dépendances : versions exactes, délai avant adoption des nouvelles publications et installations avec `--ignore-scripts`. Le prix des modèles d'IA utilisés avec Pi n'est pas abordé dans les sources.

## Quelques repères

- **MCP** : Protocole ouvert qui permet à une application d'IA de se connecter à des outils et à des services externes de façon standardisée.
- **Bac à sable** : Environnement isolé où un programme s'exécute avec des droits limités. Une erreur ou un comportement imprévu ne touche alors pas le reste de la machine.
- **Modèle de langage** : Programme d'IA entraîné sur de très grandes quantités de texte, capable d'en produire à son tour, y compris du code, à partir d'une consigne.

## Questions fréquentes

### Pi est-il gratuit et open source ?

Oui, Pi est open source et publié sous licence MIT, tout comme Pi Durable. Les sources ne précisent pas le coût des modèles d'IA que tu utilises avec.

### Pi fonctionne-t-il avec d'autres modèles que ceux d'Anthropic ou d'OpenAI ?

Oui. Selon Next, Pi est compatible avec plus de 1 500 modèles et variantes, sans dépendre d'Anthropic ou d'OpenAI. Son API unifiée couvre notamment OpenAI, Anthropic et Google.

### Comment installer Pi sur Windows ou sur Linux ?

Pi s'installe avec un script : une commande `curl` pour le shell, et une commande PowerShell pour Windows. Les deux sont reprises dans la section d'installation de cet article.

### Pi limite-t-il l'accès à mes fichiers et à mon réseau ?

Non, Pi n'a pas de système de permissions intégré et tourne avec les droits de l'utilisateur qui le lance. Pour isoler l'agent, la documentation propose l'extension Gondolin, Docker ou OpenShell.

## À retenir

Pi est un harnais d'agent de code open source sous licence MIT, qui s'utilise avec de nombreux modèles d'IA et qui a atteint la version 1.0 le 1er octobre 2026. Il n'intègre aucun système de permissions : pour limiter ses accès, il faut le placer dans un conteneur ou un bac à sable.

Mots-clés : agent de code, terminal, open source, mcp, multi-modèles, typescript

---

Fiche publiée par Geekus : https://geekus.fr/projets/pi/