Puruto

¿Qué es Puruto?

Puruto es un framework de desarrollo para crear aplicaciones agénticas. Define un estándar para empaquetar apps de forma que cualquier agente de código las entienda y ejecute — sin configuración adicional.

La idea central: el repositorio es la aplicación. El agente lee el repo, sabe quién es, qué puede hacer y cómo comportarse.

Requisito clave

Puruto no incluye un agente ni un modelo LLM. Para usar comandos como /init y /puruto-generator necesitas un agente compatible con SKILL.md (por ejemplo Claude Code, Codex, Gemini CLI o Windsurf). Si no, puedes usar el framework por CLI con scripts Python.

Estándar abierto

Basado en el formato SKILL.md, adoptado por Claude Code, Gemini CLI, Codex y Windsurf desde diciembre 2025. Escríbelo una vez, ejecútalo en cualquier agente.

Ecosistema local

Todo vive en ~/purutos/. Puruto en sí no depende de cloud (aunque el agente/runner que uses puede requerir red o un plan de pago). Tus datos, tu máquina, tus reglas.

Generador incluido

Un comando crea un repo Puruto completo: CLAUDE.md, agent.md, 4 skills base, .env.example y README — todo funcional desde el primer momento.

Componible

Conecta Purutos entre sí con IPC agéntico. puruto-data como bóveda de datos, puruto-telegram como conector móvil.

Empieza rápido

Antes de empezar, revisa:

• Requisitos
• Agentes y modelos

# 1. Clona el framework
git clone https://github.com/pepetox/puruto.git && cd puruto

# 2. Instala la dependencia del generador
pip install jinja2

# 3. Abre el repo en tu agente compatible e inicializa el ecosistema
/init

# 4. Crea tu primera app
/puruto-generator

Si aún no usas un agente compatible, puedes empezar por CLI:

python3 .claude/skills/puruto-generator/scripts/generate.py \
  --name puruto-demo \
  --description "Puruto de ejemplo"

Purutos del ecosistema

puruto-data Bóveda de datos privada. Todos los Purutos leen y escriben aquí.

puruto-telegram Conector móvil con enrutamiento determinista por canal activo.

puruto-cron Scheduler local de jobs asíncronos con SQLite y notificaciones.

puruto-gateway API REST unificada para exponer comandos de Purutos activos.

---

プルト (Puruto) — adaptación fonética japonesa de Plutón. Pequeño, con ecosistema propio.