Kuko usa inteligencia artificial para generar código automáticamente. Creás un proyecto, describís tareas, y la IA genera el código por vos. Todo corre en tu servidor, sin costes de API.
1
Creá un proyecto
Andá a Proyectos y creá uno nuevo. Dale un nombre, describí de qué se trata, elegí el stack (Go, Python, etc.).
💡 Pensá en el proyecto como la app que querés construir.
2
Agregá tareas
Desde el detalle del proyecto, agregá tareas describiendo qué querés que la IA construya. Sé específico: "Generar un handler HTTP para login".
💡 Tareas cortas y concretas funcionan mejor.
3
Ejecutá la tarea
Hacé clic en "Ejecutar" en el detalle de la tarea. El agente IA va a pensar y generar código en vivo — lo vas a ver línea por línea con streaming.
💡 La ejecución puede tardar unos minutos.
4
Revisá el código
Cuando la ejecución termina, podés ver los archivos generados en el visor de código. Navegá por el file tree, revisá el código, cambiá entre Preview y Raw.
💡 El código es tuyo — revisalo antes de aplicar.
5
Aplicá los cambios
Si el código te sirve, hacé clic en "Aplicar cambios". Kuko escribe los archivos al disco y corre go vet para verificar que compile.
💡 Los archivos se crean en el servidor, listos para usar.
¿Dudas? Usá el Chat
Si no sabés por dónde empezar, hablá con el agente desde el Chat. Puede ayudarte a definir tu proyecto, crear tareas, y responder preguntas.
Quiero construir un SaaS de gestión de inventario para cadenas de restaurantes. Multi-sede, control de mermas, previsión de compra con histórico de ventas y alertas de stock bajo por Telegram.
Kuko · Product+Architecture14:08:41 · claude-sonnet-4.5 · 2,140 tok · €0.018
Análisis de la idea
Viable como MVP en 3 iteraciones. Propongo arquitectura multi-tenant con aislamiento por tenant_id y estos módulos:
Módulo
Alcance MVP
Pipeline
Estimación
Inventario core
Stock por sede, lotes, mermas
Dev + QA
~2 días
Previsión
Media móvil + estacionalidad simple
Research → Dev
~1 día
Alertas Telegram
Bot + reglas de umbral
DevOps
~0.5 días
Multi-sede
RBAC por sede y consolidado
Architecture
~1 día
Stack recomendado
Backend: FastAPI + Postgres (RLS por tenant) + Redis para colas
Frontend: Next.js 15 + Tailwind, PWA para uso en cocina
# Documento Maestro — StockPilot## 1. Visión
Reducir mermas >15% en cadenas de restauración mediante
inventario predictivo y alertas operativas.
## 2. Requisitos clave
- RF-01 Inventario multi-sede en tiempo real
- RF-02 Registro de mermas con causa
- RF-03 Previsión de compra semanal
- RF-04 Alertas Telegram < 60s desde umbral
① Research ✓② Product ✓③ Architecture④ UX/UI⑤ Dev⑥ QA⑦ Deploy
¿Confirmas el alcance del MVP o prefieres ajustar módulos antes de generar el Documento Maestro completo?
AD
Tú14:11:03
Perfecto. Mantén los 4 módulos pero la previsión déjala simple en el MVP. Prioridad a alertas.
Kuko · Product14:11:19 · claude-sonnet-4.5 · 1,030 tok · €0.009
Anotado en memoria del proyecto: “previsión simple en MVP, alertas prioritarias”. Backlog inicial reordenado:
v1.4modificado hace 2 h · por arquitecto (claude-opus-4.1)VALIDADO 6/9
1. Visión APROBADA
TPV offline-first para retail que sincroniza inventario en tiempo real entre tiendas y un backoffice central. Objetivo: cero ventas perdidas por caídas de red y trazabilidad completa de stock.
→ vinculada a tareas: T-101, T-102, T-118 · última edición hace 5 d
2. Alcance APROBADA
Incluye: catálogo, inventario multi-tienda, caja con modo offline, sincronización diferida, informes de mermas. Excluye (v1): facturación electrónica, fidelización, app de cliente.
3. Requisitos funcionales EN REVISIÓN
14 requisitos activos. RF-07 (sincronización LWW) propuesto a cambio por CRDT — ver comentario del arquitecto. Cada requisito está trazado a tareas del backlog.
Req
Descripción
Tarea
Estado
RF-01
Venta offline con cola local
T-118
RUNNING
RF-02
Sync multi-tienda < 30 s
T-120
REVIEW
RF-03
Alerta stock bajo
T-124
PENDING
4. Arquitectura CAMBIOS PENDIENTES
Cliente PWA (Next.js) → API FastAPI → Postgres con partición por tienda. Outbox pattern para sincronización. Redis para locks de inventario. El comentario #c-118 propone mover el lock a advisory locks de Postgres.
Flujos de caja optimizados para táctil en horizontal. Paleta y componentes pendientes de aprobación.
7. Seguridad APROBADA
RBAC por rol (cajero/encargado/admin), JWT rotativo, cifrado at-rest, auditoría de anulaciones de ticket.
8. Despliegue BORRADOR
Docker compose en VPS staging; producción en Fly.io con réplicas por región. Pendiente definir estrategia de actualización de terminales.
9. Riesgos REVISAR
R-02: colisiones de sync bajo cortes largos > 6 h — mitigación propuesta en sección 4. R-05: hardware de caja heterogéneo.
Memoria del proyectocontexto persistente
Decisión arquitectónica — LWW sobre CRDT12 jul · arquitecto
Para retail con cortes < 6 h, last-write-wins con timestamp de terminal es suficiente y mucho más simple que CRDT. CRDT queda como evaluación para v2.
Error encontrado — race en locks de stock13 jul · qa
Dos terminales offline podían vender la misma unidad. Solución: advisory lock de Postgres en la confirmación + reconciliación con prioridad a venta confirmada.
Preferencia del usuario13 jul · producto
“La pantalla de caja debe funcionar con una mano y sin teclado.” Aplicado a todos los flujos táctiles.
Riesgo identificado — sync tras cortes largos14 jul · arquitecto
Cortes > 6 h generan > 200 conflictos. Mitigación: baja forzada de terminal a modo “solo consulta” tras 2 h offline.
Cambio de alcance14 jul · producto
Loyalty/fidelización movido fuera de v1. Documento Maestro §2 actualizado (v1.3 → v1.4).
Lección aprendida — seeds en CI15 jul · devops
Los seeds con FK estrictas fallan en paralelo. Solución aplicada: seed por lotes ordenados con --serial.
Suposición registrada15 jul · pm
Máximo 4 terminales por tienda en el primer año. Si crece, revisar particionado de stock_levels.
Restricciones activas
hardSin dependencias con licencia AGPL
hardDatos de clientes solo en EU
softBundle del terminal < 400 KB
softLatencia API p95 < 180 ms
Dependencias críticas
postgres16.4 · pinned
redis7.2 · pinned
next15.1.0 · locked
fastapi0.115 · locked
Feed de actividad
Ejecución iniciada — T-118 “Cola local de ventas offline” · agente dev · claude-sonnet-4.5 AUTOMÁTICA
Despliegue a producciónMigraciones de base de datosEliminación de recursos / datosCambios en el Documento MaestroInstalación de nuevas dependenciasAcceso a secretos de producción
Avisar al 50% del presupuestoAvisar al 80% + TelegramBloquear modelos PAID al 95%Forzar fallback a Ollama al 100%
Límite por tarea (€)
Interruptores globales del pipeline autónomo. Desactivar un módulo pausa sus agentes en todos los proyectos; las tareas en curso finalizan de forma segura.
Research
investigación
Product
docs maestros
Analysis
análisis técnico
Architecture
diseño sistema
UX/UI Design
interfaces
Development
código
QA
tests
Security
SAST/DAST
DevOps
infra
Deployment
releases
Monitoring
observabilidad
Documentation
docs auto
Memory
contexto persistente
Cost Control
governor de gasto
Code Review
revisión auto
Project Mgmt
planificación
Timestamp
Nivel
Módulo
Proveedor
Acción
Detalle
Estado
14:31:52.411
INFO
Dev
claude
exec.step
T-118 paso 7 · subtarea 3/6 iniciada
ok
14:31:48.002
DEBUG
Dev
claude
ctx.load
memoria: 23 entries · 8.1k tokens
ok
14:29:16.730
WARN
Cost Ctrl
openai
budget.check
helix-crm al 76% del límite diario (€19.02/€25)
alerta
14:22:03.118
ERROR
DevOps
ollama
seed.run
FK constraint fk_sale_store violada · reintento 3/3
fail
14:20:02.540
INFO
DevOps
system
approval.req
migración v3 solicitada → admin (nova-pos)
pend.
14:12:47.991
INFO
Dev
claude
git.commit
a3f9c21 feat(pos): persist offline sale queue
ok
13:58:11.204
WARN
QA
openai
api.latency
openai p95 1.9 s > umbral 1.2 s — degradado
alerta
12:44:50.377
CRIT
Security
system
policy.block
intento de lectura fuera del sandbox bloqueado (/etc/shadow)
bloqueado
12:31:04.655
INFO
Product
claude
doc.update
master-doc nova-pos §4 v1.3 → v1.4
ok
11:02:31.812
DEBUG
Memory
ollama
mem.index
reindex embeddings · 1,204 vectores · 812 ms
ok
Ollama LOCALFREE
OPERATIVO
Endpointhttp://localhost:11434
Latencia41 ms
Modelos7 cargados · 4 activos
Consumo hoy1.2K req · €0.00
API keyno requerida
Fallback→ claude-haiku-4
Anthropic CLOUDPAID
OPERATIVO
Endpointapi.anthropic.com
Latencia380 ms
API keysk-ant-••••••4f2a
Consumo hoy€24.80 · 8.2M tok
Límite diario€40 (62%)
Fallback→ gpt-5
OpenAI CLOUDPAID
DEGRADADO
Endpointapi.openai.com
Latencia1.9 s ↑
API keysk-proj-••••••91b7
Consumo hoy€10.15 · 1.1M tok
Límite diario€25 (41%)
Fallback→ claude-sonnet-4.5
retry 429 activo ×3
Codex CLOUDPAID
OPERATIVO
Endpointapi.openai.com/codex
Latencia640 ms
CredencialOAuth ✓ vinculada
Consumo hoy€2.92 · 3 tareas
Límite diario€15 (19%)
Fallback→ qwen2.5-coder
GitHubCONECTADO
Repos, PRs y webhooks de CI en ex44/*.
GitLabNO CONFIG.
Alternativa de hosting y CI.
DockerCONECTADO
Sandboxes de ejecución · 27.1.3 · 3 contenedores activos.
Despliegue a producción siempreEliminación de recursos / datosMigraciones destructivas de BDGasto de tarea > €5Instalación de dependencias nuevasModificación del Documento Maestro
Seguridad y acceso
Agentes confinados al sandbox no desactivableBloquear lectura fuera del workspaceComandos con sudo → prohibidosAcceso a secretos de producción → solo con aprobaciónEscaneo SAST obligatorio antes de commitRed saliente limitada a whitelist de dominios
Uso de modelos
Datos de producción nunca a modelos cloudPreferir modelos locales (Ollama) en tareas rutinariasFallback automático ante degradaciónRegistrar todos los prompts (auditoría)
Presupuesto e infra
Bloqueo global al 100% del presupuestoMáx. sandboxes simultáneos: 4Destruir sandbox idle tras 30 minDespliegues solo desde CI verificado
Servidor
OK
CPU · 8 cores42%
RAM11.2/32 GB
Disco NVMe214/500 GB
GPU · RTX 4090 (Ollama)68%
Temperatura GPU61°C
Servicios y workers
postgres 16.428 d up
redis 7.228 d up
ollama 0.9.2GPU 68%
workers ×66/6 idle-able
colas ×42 pendientes
sandboxes3/4 activos
Versiones y actualizaciones
Kuko Corev1.0.0
Agent runtimev1.18.0
Node22.14.0
Python3.12.8
Docker27.1.3
Actualización disponible: Core v2.5.0
ex44-core — journal en vivoSTREAM
14:32:01[core]heartbeat ok · workers 6/6 · queues depth 2
14:32:01[sbx]sbx-114 cpu 38% mem 1.2GB net 12KB/s
14:31:58[cost]tick: nova-pos +€0.0041 (total día €38.42)