Repolode
Enviar
bigfish1913

bigfish1913/pi-rust

Runtime para agentes de programación nativo de Rust y centrado en la biblioteca, con CLI de terminal (rpi), adaptadores de proveedores, herramientas, sesiones persistentes y una ABI estable para plugins.

Alternativa open source a:Claude CodeCodex CLI

Ver en GitHubSitio web
Estrellas
208
Forks
40
Issues abiertos
6
Último commit
hace 14 horas

¿Qué es?

rpi es un runtime para agentes de programación escrito en Rust y dividido en diez crates componibles que abarcan adaptadores de proveedores, un bucle de agente, herramientas, persistencia de sesiones, una interfaz de terminal y una ABI para plugins. El mismo código puede integrarse en tu propio proceso como SDK o usarse directamente mediante el agente de línea de comandos `rpi`, que ofrece una TUI interactiva, un modo de ejecución única y salida de eventos en JSON.

Las sesiones se almacenan como árboles JSONL y, si se produce un fallo durante la ejecución, se reanudan desde el último frame confirmado. Las pasarelas compatibles con Anthropic y OpenAI se configuran mediante un archivo models.json, y el proveedor determinista sin conexión `faux` permite ejecutar pruebas y ejemplos sin una clave de API ni acceso a la red.

Los plugins son bibliotecas Rust cdylib que usan una ABI C escrita a mano con #[repr(C)] y pueden registrar herramientas, proveedores, comandos slash y manejadores de eventos. El proyecto también incluye un modo de servidor sin interfaz al que un cliente TUI ligero puede conectarse por TCP. Es una reimplementación en Rust del SDK Pi para TypeScript y no carga extensiones de Node ni de npm.

Funciones clave

  • 01Bucle de agente integrable mediante los crates rpi-agent y rpi-ai, utilizable sin la CLI.
  • 02Proveedor determinista sin conexión `faux` para ejecutar pruebas y ejemplos sin acceso a la red.
  • 03Sesiones que se pueden reanudar tras un fallo y se almacenan como árboles JSONL.
  • 04Herramientas integradas para read, write, edit, bash, grep, find y ls.
  • 05ABI para plugins con extensiones cdylib que pueden registrar herramientas, proveedores y comandos.
  • 06Modo de servidor sin interfaz con un cliente TUI ligero conectado por TCP.

Casos de uso

  • Integrar un agente de programación con herramientas personalizadas y gestión de eventos en tu propia aplicación Rust.
  • Escribir pruebas sin conexión para flujos de trabajo de agentes, sin claves de API ni llamadas a la red.
  • Ejecutar un agente de programación en la terminal de una máquina local y controlarlo desde un cliente ligero en otra máquina.
  • Crear un plugin de herramientas reutilizable que funcione tanto en la CLI global como en un agente integrado.

Inicio rápido

  1. 1

    Instala la CLI rpi desde crates.io (requiere Rust 1.88 o posterior)

    cargo install rpi-cli
  2. 2

    Configura una clave API para tu proveedor de modelos

    export ANTHROPIC_API_KEY=...
  3. 3

    Inicia la interfaz de terminal interactiva

    rpi

Antes de usarlo

  • Para instalar desde crates.io o desde el código fuente, se requiere Rust 1.88 o posterior.
  • La fórmula de Homebrew solo es compatible con Apple silicon en macOS; los Mac con Intel necesitan el instalador precompilado o cargo.
  • Para ejecutar la CLI con modelos reales, necesitas una clave API del proveedor o una configuración models.json.

En colecciones

Agentes de programación con IAAsistentes y agentes de programación con IAHerramientas de CLI y terminal

Temas

#agent-framework#coding-agent#llm#rust#cli#sdk#plugins#terminal-agent#agent#ai

Preguntas frecuentes

¿Qué es pi-rust?
Runtime para agentes de programación nativo de Rust y centrado en la biblioteca, con CLI de terminal (rpi), adaptadores de proveedores, herramientas, sesiones persistentes y una ABI estable para plugins. rpi es un runtime para agentes de programación escrito en Rust y dividido en diez crates componibles que abarcan adaptadores de proveedores, un bucle de agente, herramientas, persistencia de sesiones, una interfaz de terminal y una ABI para plugins. El mismo código puede integrarse en tu propio proceso como SDK o usarse directamente mediante el agente de línea de comandos `rpi`, que ofrece una TUI interactiva, un modo de ejecución única y salida de eventos en JSON.
¿pi-rust es gratuito? ¿Qué licencia tiene?
pi-rust es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿pi-rust sigue mantenido?
Mantenimiento activo. El último commit de pi-rust fue el 6 nov 2026.
¿Para qué puedo usar pi-rust?
Integrar un agente de programación con herramientas personalizadas y gestión de eventos en tu propia aplicación Rust. Escribir pruebas sin conexión para flujos de trabajo de agentes, sin claves de API ni llamadas a la red. Ejecutar un agente de programación en la terminal de una máquina local y controlarlo desde un cliente ligero en otra máquina. Crear un plugin de herramientas reutilizable que funcione tanto en la CLI global como en un agente integrado.
¿Cómo se instala pi-rust?
Instala la CLI rpi desde crates.io (requiere Rust 1.88 o posterior): cargo install rpi-cli Configura una clave API para tu proveedor de modelos: export ANTHROPIC_API_KEY=... Inicia la interfaz de terminal interactiva: rpi
¿Dónde consigo pi-rust?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/bigfish1913/pi-rust

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados