Construí software con IA sobre tu propia infraestructura
Kuko convierte ideas y Documentos Maestros en proyectos ejecutables. Agentes inteligentes, memoria persistente, modelos locales y ejecución con control total.
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 explorar ideas y responder preguntas; crear tareas no está disponible desde Chat.
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
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.