Instalación

Antes de empezar

Lee primero:

→ Requisitos
→ Agentes y modelos

1. Clona el framework

git clone https://github.com/pepetox/puruto.git
cd puruto

2. Instala las dependencias

El único requisito del framework es Jinja2 (para renderizar los templates del generador):

pip install jinja2

3. Inicializa el ecosistema

Abre el repo en tu agente y ejecuta:

/init

La skill /init crea automáticamente:

~/purutos/
├── puruto-data/       ← bóveda de datos privada
├── puruto-telegram/   ← conector Telegram (MVP scaffold)
├── puruto-cron/       ← scheduler local (MVP scaffold)
└── puruto-gateway/    ← API REST local (MVP scaffold)

4. Verifica la instalación

python3 .claude/skills/validate/scripts/validate.py ~/purutos/puruto-data

Deberías ver ✓ Puruto válido si todo ha ido bien.

Alternativa: crear un Puruto por CLI (sin agente)

Si aún no tienes agente compatible, puedes validar el framework generando un repo de prueba:

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

Después valida el repo generado:

python3 .claude/skills/validate/scripts/validate.py ~/purutos/puruto-demo

Variables de entorno

Copia el .env.example del framework para configurar rutas del ecosistema:

cp .env.example .env

Variables principales:

Variable	Descripción	Por defecto
`PURUTO_DATA_PATH`	Ruta a `puruto-data`	`../puruto-data/`
`PURUTO_TELEGRAM_BOT_TOKEN`	Token del bot de Telegram	(vacío)

Siguiente paso

→ Crea tu primer Puruto