Zaru Get Zaru free

Guides

Zaru CLI : ce qu'elle fait et comment l'installer, d'après son README

Aussi en: English, Español, Português, 日本語, Deutsch, 한국어, 简体中文, Italiano, हिन्दी · Tous les guides en français

Transparence : Zaru est développé par 100monkeys AI, Inc. ; lisez donc ce guide comme le récit de son fabricant. Il a été rédigé par l'un de nos agents d'IA à partir du README de zaru-cli (en anglais) sur sa branche main, lu le 28 octobre 2026, et relu par l'entreprise ; cette version française est une traduction du guide original en anglais. Chaque commande ci-dessous est copiée de ce README. Là où le README ne répond pas à une question, nous le disons plutôt que de combler le vide.

Le README en une phrase : "Zaru is an AI assistant that works in your terminal. You give it a task, it asks a language model, and it runs the tools the model asks for: it reads and edits files, runs commands and fetches web pages, asking your permission first." (Zaru est un assistant d'IA qui travaille dans votre terminal. Vous lui donnez une tâche, il interroge un modèle de langage et exécute les outils que le modèle demande : il lit et modifie des fichiers, lance des commandes et récupère des pages web, en vous demandant d'abord l'autorisation.) Chaque étape est consignée dans un journal en texte brut que vous pouvez lire avec cat.

Savoir où elle en est

Le README le dit franchement : "It is pre-alpha: there are no releases and no packages, you build it from source, and commands, files and settings can change without notice." (Elle est en pré-alpha : il n'y a ni version publiée ni paquet, vous la compilez depuis les sources, et les commandes, fichiers et réglages peuvent changer sans préavis.) Elle est open source sous Apache-2.0. Ce n'est pas non plus un bac à sable : "Zaru acts on your machine with your user account's permissions." (Zaru agit sur votre machine avec les droits de votre compte utilisateur.) Lisez la section Safety du README avant de la lâcher sur quoi que ce soit qui compte pour vous.

Étape 1. Vérifier les prérequis

Étape 2. Compiler et installer

git clone https://github.com/100monkeys-ai/zaru-cli.git
cd zaru-cli
cargo install --path crates/zaru-cli --locked

Cela place zaru dans ~/.cargo/bin. Lancez zaru --version pour vérifier qu'elle fonctionne.

Étape 3. Choisir un modèle

"Zaru has no default model." (Zaru n'a pas de modèle par défaut.) Vous créez ~/.zaru/config.toml vous-même. Pour Gemini, enregistrez la clé (elle est lue sur l'entrée standard : collez-la, appuyez sur Entrée, puis sur Ctrl-D) et nommez le modèle :

zaru providers keys add gemini
[model]
default = "gemini-3.6-flash"

Les clés enregistrées sont chiffrées avec une clé conservée dans le trousseau du système d'exploitation. Sur une machine sans trousseau, comme un serveur, WSL ou un conteneur, donnez à ZARU_CREDENTIAL_KEY 64 caractères hexadécimaux en minuscules et gardez cette valeur, car "without it, the keys you stored cannot be read again." (sans elle, les clés enregistrées ne peuvent plus être lues.) Pour Ollama, aucune clé n'est nécessaire : mettez kind = "ollama" sous [provider.default], et Zaru se connecte à http://localhost:11434. Pour un serveur compatible OpenAI, mettez kind = "openai-compatible" et son endpoint, plus context_tokens si la liste des modèles du serveur ne donne pas la fenêtre de contexte.

Étape 4. Lancer une tâche

zaru "read src/main.rs and tell me what it does"

Lancez-la depuis le répertoire où elle doit travailler. Elle affiche l'avertissement indiquant qu'elle n'est pas un bac à sable, chaque appel d'outil avec ce qu'il a fait, la réponse, les tokens "counted by the provider" (comptés par le fournisseur) et une note sur les validateurs. zaru sans argument ouvre plutôt une session interactive ; zaru --continue rouvre la dernière dans le répertoire courant.

Étape 5. Répondre aux demandes d'autorisation

Avant une écriture de fichier, une modification, une commande ou une récupération web, Zaru montre ce que l'appel va faire et demande [y/N/a ...]. y l'autorise une fois, a autorise cet appel exact pour la session, et N, Entrée ou Échap dit non pendant que la tâche continue. Ctrl-C arrête toute la tâche. Une récupération affiche l'URL entière, "because a URL can carry data off your machine" (parce qu'une URL peut emporter des données hors de votre machine). Sans terminal où poser la question, l'appel est refusé. Le mode est ask par défaut ; allow saute ce qui figure sur votre liste d'autorisation, et yolo ne demande rien, ce que le README réserve "only for a directory and a task you trust entirely." (uniquement à un répertoire et à une tâche en qui vous avez entièrement confiance.)

Étape 6. Lire le journal

zaru sessions list
cat ~/.zaru/sessions/<id>/transcript.jsonl

Un objet JSON par ligne : votre tâche, chaque réponse du modèle et les appels d'outil qu'il a demandés, si chaque appel a été autorisé, ce qu'il a renvoyé "exactly as the model was given it" (exactement tel que le modèle l'a reçu), et la réponse. Les clés et tokens enregistrés sont remplacés par un marqueur avant que quoi que ce soit soit écrit.

Étape 7. Ajouter un validateur

zaru init écrit un exemple de ./zaru.toml. Un validateur est une commande qui vérifie le travail du modèle :

[[validator]]
name = "test"
run = "cargo test"
expect = "exit-zero"

Avec des validateurs déclarés, une tâche devient une boucle : le modèle change quelque chose, les validateurs s'exécutent, et un échec revient au modèle, jusqu'à ce que tous passent ou que runtime.max_iterations soit atteint. Les validateurs ne s'exécutent qu'après votre accord, et la question vous est reposée quand ils changent ; "the permission mode does not skip it." (le mode d'autorisation ne la saute pas.)

Ce qu'elle ne fait pas encore

Ce que le README laisse ouvert

Guides liés

Vous voulez Zaru sans rien compiler ? L'application web est gratuite : "Your name and email. That is all it asks." (Votre nom et votre e-mail. C'est tout ce qu'elle demande.)

Get Zaru free