Zaru Get Zaru free

Guías

Zaru CLI: qué hace y cómo instalarla, según su README

También en: English, Português, 日本語, Deutsch, Français, 한국어, 简体中文, Italiano, हिन्दी · Todas las guías en español

Aviso: Zaru lo construye 100monkeys AI, Inc., así que lee esta guía como el relato de quien lo fabrica. La redactó uno de nuestros agentes de IA a partir del README de zaru-cli en su rama main, leído el 28 de octubre de 2026, y la revisó la empresa; esta versión en español es una traducción de la guía original en inglés. Cada comando de abajo está copiado de ese README, y las citas van en inglés con la traducción al lado. Donde el README no responde a una pregunta, lo decimos en lugar de rellenarla.

El README en una línea: "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 es un asistente de IA que trabaja en tu terminal. Le das una tarea, consulta a un modelo de lenguaje y ejecuta las herramientas que el modelo pide: lee y edita archivos, ejecuta comandos y descarga páginas web, pidiéndote permiso primero.) Cada paso queda en una transcripción de texto plano que puedes leer con cat.

Sabe en qué etapa está

El README lo dice sin rodeos: "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." (Está en pre-alfa: no hay versiones publicadas ni paquetes, se compila desde el código, y los comandos, archivos y ajustes pueden cambiar sin aviso.) Es de código abierto bajo Apache-2.0. Tampoco es un sandbox: "Zaru acts on your machine with your user account's permissions." (Zaru actúa en tu máquina con los permisos de tu cuenta de usuario.) Lee la sección Safety del README antes de apuntarlo a algo que te importe.

Paso 1. Comprueba los requisitos

Paso 2. Compila e instala

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

Esto deja zaru en ~/.cargo/bin. Ejecuta zaru --version para comprobar que funciona.

Paso 3. Elige un modelo

"Zaru has no default model." (Zaru no tiene modelo por defecto.) Tú creas ~/.zaru/config.toml. Para Gemini, guarda la clave (se lee de la entrada estándar: pégala, pulsa Enter y luego Ctrl-D) y nombra el modelo:

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

Las claves guardadas se cifran con una clave que se guarda en el llavero del sistema operativo. En una máquina sin llavero, como un servidor, WSL o un contenedor, fija ZARU_CREDENTIAL_KEY a 64 caracteres hexadecimales en minúscula y conserva ese valor, porque "without it, the keys you stored cannot be read again." (sin él, las claves que guardaste no se pueden volver a leer). Para Ollama no hace falta clave: pon kind = "ollama" bajo [provider.default] y Zaru se conecta a http://localhost:11434. Para un servidor compatible con OpenAI, pon kind = "openai-compatible" y su endpoint, y además context_tokens si la lista de modelos del servidor no da la ventana.

Paso 4. Ejecuta una tarea

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

Ejecútalo desde el directorio en el que quieres que trabaje. Muestra el aviso de que no es un sandbox, cada llamada a herramienta con lo que hizo, la respuesta, los tokens "counted by the provider" (contados por el proveedor) y una nota sobre validadores. zaru sin argumentos abre en cambio una sesión interactiva; zaru --continue reabre la última en el directorio actual.

Paso 5. Responde a las preguntas de permiso

Antes de escribir un archivo, editarlo, ejecutar un comando o descargar una página, Zaru muestra lo que hará la llamada y pregunta [y/N/a ...]. y la permite una vez, a permite esa misma llamada durante la sesión, y N, Enter o Esc dicen que no mientras la tarea sigue. Ctrl-C detiene toda la tarea. Una descarga muestra la URL completa, "because a URL can carry data off your machine" (porque una URL puede sacar datos de tu máquina). Si no hay terminal en la que preguntar, la llamada se rechaza. El modo es ask por defecto; allow se salta lo que está en tu lista permitida, y yolo no pregunta nada, algo que el README dice usar "only for a directory and a task you trust entirely." (solo para un directorio y una tarea en los que confías del todo).

Paso 6. Lee la transcripción

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

Un objeto JSON por línea: tu tarea, cada respuesta del modelo y las llamadas a herramientas que pidió, si cada llamada se permitió, lo que devolvió "exactly as the model was given it" (exactamente como se le dio al modelo) y la respuesta. Las claves y tokens guardados se sustituyen por un marcador antes de escribir nada.

Paso 7. Añade un validador

zaru init escribe un ./zaru.toml de ejemplo. Un validador es un comando que comprueba el trabajo del modelo:

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

Con validadores declarados, una tarea se convierte en un bucle: el modelo cambia algo, los validadores se ejecutan y un fallo vuelve al modelo, hasta que todos pasan o se alcanza runtime.max_iterations. Los validadores solo se ejecutan después de que los apruebes, y se te vuelve a preguntar cuando cambian; "the permission mode does not skip it." (el modo de permisos no se salta esa pregunta).

Lo que aún no hace

Lo que el README deja abierto

Guías relacionadas

¿Quieres Zaru sin compilar nada? La aplicación web es gratis: "Your name and email. That is all it asks." (Tu nombre y tu correo. Es todo lo que pide.)

Get Zaru free