Desktop Buddy

documentación del proyecto

Un compañero de escritorio abierto y hackeable sobre ESP32, hecho por y para nuestro HackLab. Todo lo que hay aquí es una propuesta — discútela.

Las tarjetas marcadas interactiva se abren aquí mismo. Las marcadas markdown se leen mejor en GitHub, así que apuntan allí.

Empezar

markdownREADME
Qué es el buddy, arranque en 5 minutos, qué placa te da qué, y dónde se mete cada equipo.
markdownCómo contribuir
Ramas y spikes, commits, idiomas, cómo añadir un evento al bus, reglas del firmware.
markdownArquitectura y producto
El documento fundacional: identidad, contrato de Brain, packs, voz, hitos.
markdownPlan de talleres
Las 4 sesiones, los tres tracks en paralelo y las notas de riesgo.

Decisiones y reuniones

interactivaReunión de equipos
Banco de frases vs modelo local, las 8 emociones con sus caras reales, equipos y líderes, BOM y diagrama de cableado.
interactivaRegistro de ideas
15 hilos abiertos y callejones sin salida, con el número exacto que mató a cada uno. Filtrable.
interactivaArquitectura, visual
La misma arquitectura del documento fundacional, explorable.
markdownBrief de presentación
El brief original con el que se presentó la idea al lab.

Referencia técnica

interactivaRegistro de eventos
El contrato entre equipos: los 15 eventos del bus con sus sitios reales de publicación y suscripción, dueños por prefijo y agujeros conocidos.
markdownRegistro de eventos, en texto
La misma lista, greppable y diffable — es la versión que se edita en el PR cuando añades un evento.
interactivaArquitectura del firmware
El bus en marcha, las tareas por núcleo, los dos targets y la tabla de emociones dibujándose en vivo.
markdownHardware y BOM
Componentes, pedidos, sensores, alimentación, carcasa y presupuesto de pines.
markdownGuías de cableado
Paso a paso por placa: ESP32-S3 y ESP32 clásico, con checklist de primer arranque.
markdownFormato de packs
El contrato de los packs de personalidad. Borrador para discusión.
markdownServicios externos
LLM, STT y TTS: proveedores, precios y el coste real por interacción.

Modelo de IA local

interactivaExplorador de parámetros
Mueve los mandos del modelo y mira cómo cambian tamaño, velocidad en la placa y memoria. Para el proyector.
markdownTaller de entrenamiento
De cero experiencia en ML a un modelo propio corriendo en el buddy. Receta completa.
markdownPaso 0: ¿corre el modelo?
La medición que abrió la puerta: sí, y a qué velocidad.
markdownSpike del kernel
De 31 a 152 tok/s, con cada paso medido. Vive en la rama spike/tinylm-s3.