El rack es el estudio. El estudio es el rack. No es un homelab.
El rack de 12U en el piso del hogar de los fundadores es la primera oficina de YOSO-YAi LLC. El sustrato de produccion de una empresa de tecnologia de infraestructura. No es un homelab.
Este repositorio documenta el rack de 12U que opera YOSO-YAi LLC. No es un homelab. No es un proyecto de fin de semana. Es la infraestructura de produccion completa de la firma: compute, red, bateria, enfriamiento, y el firmware que lo mantiene vivo. El ADN de cuatro superficies (Brain, Experiences, Nerves, Chat) corre de extremo a extremo en hardware dedicado dentro de este rack. Cada decision de construccion, cada falla, cada solucion se registra aqui como un registro publico de ingenieria. El rack es permanente. Se movera cuando la empresa se traslade a la instalacion dedicada de F18 en Puerto Rico.
- Por que este repositorio existe / Why This Repo Exists
- El rack / The Rack
- El ADN de cuatro superficies / Four-Surface DNA
- Los dos monitores / The Two Monitors
- Registro de construccion / Build Log
- Diario de decisiones / Decision Journal
- Catalogo de fotos y video / Photo and Video Catalog
- Estructura del repositorio / Repository Structure
- Licencia / License
Espanol
Este repositorio existe porque la realidad de ingenieria merece un registro publico. El rack de 12U en el piso del hogar de los fundadores no es un proyecto de fin de semana. Es la primera oficina de YOSO-YAi LLC. Es la infraestructura de produccion de la firma.
El rack es el estudio. El estudio es el rack. Todo lo que la firma produce (codigo, modelos, automatizaciones, documentacion, hardware) se origina desde este rack. Los registros de construccion documentan que paso, que se rompio, que funciono. El diario de decisiones captura el por que detras de cada eleccion tecnica. El catalogo de fotos y video indexa la evidencia visual. Sin edicion retroactiva. Sin pulir. Realidad de taller.
Cuando los inversores visitan, ven el rack con su protoboard expuesto, su flota YAi produciendo trabajo real.
English
This repository exists because engineering reality deserves a public record. The 12U rack on the floor of the founders' home is not a weekend project. It is the first office of YOSO-YAi LLC. It is the production infrastructure of the firm.
The rack is the studio. The studio is the rack. Everything the firm produces (code, models, automations, documentation, hardware) originates from this rack. Build logs document what happened, what broke, what worked. The decision journal captures the reasoning behind every technical choice. The photo and video catalog indexes the visual evidence. No retroactive editing. No polish. Workshop reality.
When investors visit, they see the rack with its breadboard exposed, its YAi fleet committing real work.
Espanol
El rack de 12U contiene todo el compute, red, bateria, y enfriamiento de la firma. Cada posicion en el rack tiene un proposito definido.
| Equipo | Funcion |
|---|---|
| DGX Spark | Potencia de ingenieria de IA: Brain, Experiences, Nerves, LiteLLM, YOSOTRON. Monitor 1. |
| Lenovo M70q | Podio del director: Chat (Mission Control). Monitor 2. |
| Estante de 5 Pi | pi-01 YAi-SE, pi-02 YAi-HE, pi-03 YAi-EE, pi-04 YAi-ML, pi-05 display dedicado de 10 pulgadas |
| RIB PCB / Protoboard expuesto | Plano de seguridad: termico, bateria, monitoreo de potencia |
| Bambu H2D | Prototipado fisico: ductos de aire, montajes, carcasas |
| NETGEAR PoE switch | Columna vertebral de red y alimentacion PoE |
| KVM | Conecta pi-01 a pi-04 al Monitor 2 |
| Display 10 pulgadas montado en rack | Dashboard de flota (manejado por pi-05) |
| Banco de baterias 10,000 mAh | UPS del rack, LiFePO4 |
| Ductos de aire impresos | Flujo de aire dirigido, disenados por Francisco |
Tailscale es el unico plano de red. Sin exposicion publica.
English
The 12U rack contains all of the firm's compute, networking, battery, and cooling. Every position in the rack has a defined purpose.
| Equipment | Function |
|---|---|
| DGX Spark | AI engineering powerhouse: Brain, Experiences, Nerves, LiteLLM, YOSOTRON. Monitor 1. |
| Lenovo M70q | Conductor's podium: Chat (Mission Control). Monitor 2. |
| Five-Pi shelf | pi-01 YAi-SE, pi-02 YAi-HE, pi-03 YAi-EE, pi-04 YAi-ML, pi-05 dedicated 10-inch display Pi |
| RIB PCB / Exposed breadboard | Safety plane: thermal, battery, power monitoring |
| Bambu H2D | Physical prototyping: air ducts, mounts, enclosures |
| NETGEAR PoE switch | Networking spine and PoE power delivery |
| KVM | Connects pi-01 through pi-04 to Monitor 2 |
| 10-inch rack-mounted display | Fleet dashboard (driven by pi-05) |
| 10,000 mAh battery bank | Rack UPS, LiFePO4 |
| Francisco-designed printed air ducts | Directed airflow across each Pi position |
Tailscale is the only network plane. No public exposure.
Espanol
El ADN de cuatro superficies es el patron arquitectonico de YOSO-YAi. Cada superficie corre en hardware dedicado dentro del rack, conectada por Tailscale como unico plano de red. El RIB es el cuerpo que cierra el ciclo fisicamente.
+----------------------------------------------------------+
| 12U RACK |
| |
| +----------------------+ +---------------------------+ |
| | BRAIN | | EXPERIENCES | |
| | Obsidian on DGX | | Forgejo on DGX :3001 | |
| | Base de conocimiento| | Git, commits, repos | |
| +----------+-----------+ +-------------+-------------+ |
| | Tailscale mesh | |
| +------------+----------------+ |
| | |
| +-----------------------+------------------------------+ |
| | NERVES | |
| | n8n on DGX | |
| | Automatizacion de flujos, | |
| | orquestacion de eventos | |
| +-----------------------+------------------------------+ |
| | |
| +-----------------------+------------------------------+ |
| | CHAT | |
| | Mission Control on M70q | |
| | Interfaz de coordinacion humana | |
| +-----------------------+------------------------------+ |
| | |
| +-----------------------+------------------------------+ |
| | BODY (RIB) | |
| | Pico 2 (RP2350A) | |
| | Termico, bateria, potencia, | |
| | salud fisica del rack | |
| +------------------------------------------------------+ |
+----------------------------------------------------------+
Forgejo en el puerto 3001 es la unica fuente de verdad de la firma.
English
The four-surface DNA is the architectural pattern of YOSO-YAi. Each surface runs on dedicated hardware inside the rack, connected by Tailscale as the sole network plane. The RIB is the body that closes the four-surface DNA loop physically.
| Surface | Host | Role |
|---|---|---|
| Brain | Obsidian on DGX | Knowledge store |
| Experiences | Forgejo on DGX at port 3001 | Git, commits, repos, single source of truth |
| Nerves | n8n on DGX | Workflow automation, event orchestration |
| Chat | Mission Control on M70q | Human coordination interface |
| Body | RIB (Pico 2 RP2350A) | Thermal, battery, power, physical health |
Forgejo at port 3001 is the firm's single source of truth.
Espanol
Monitor 1 (DGX). Conectado directamente al DGX Spark. Muestra las superficies Brain (Obsidian), Experiences (Forgejo), y Nerves (n8n). Es la vista de la infraestructura de software de la firma.
Monitor 2 (M70q + KVM). Conectado al M70q, con el KVM switch cableado a pi-01 hasta pi-04. Muestra Mission Control (superficie Chat) como vista predeterminada. El KVM permite cambiar a cualquier Pi individual para diagnostico, configuracion, o depuracion. El M70q tambien recibe la salida UART del RIB, asi que la consola serial del plano de seguridad esta siempre disponible en este monitor.
English
Monitor 1 (DGX). Connected directly to the DGX Spark. Shows the Brain (Obsidian), Experiences (Forgejo), and Nerves (n8n) surfaces. This is the view into the firm's software infrastructure.
Monitor 2 (M70q + KVM). Connected to the M70q, with the KVM switch wired to pi-01 through pi-04. Shows Mission Control (Chat surface) as the default view. The KVM allows switching to any individual Pi for diagnostics, configuration, or debugging. The M70q also receives the UART output from the RIB, so the safety plane serial console is always available on this monitor.
Espanol
Los registros de construccion se mantienen en build-log/. Cada entrada es un archivo markdown con un formato estricto. Sin edicion retroactiva. Lo que se escribio el dia de la construccion permanece como fue escrito.
# YYYY-MM-DD -- Titulo breve
## Que se hizo
Descripcion del trabajo realizado. Componentes instalados, cables
tendidos, firmware flasheado, configuracion aplicada.
## Que se rompio
Fallas encontradas. Componentes danados. Errores de cableado.
Problemas de firmware. Si nada se rompio, la seccion dice "Nada."
## Que funciono
Resultados exitosos. Mediciones. Capturas de pantalla. Salida
de consola. Evidencia verificable.
## Fotos / Video
Lista de archivos en catalog/ con referencia cruzada.
| Archivo | Descripcion |
|---------|-------------|
| YYYY-MM-DD-001.jpg | Descripcion de la imagen |
## Notas
Observaciones, ideas para la proxima sesion, preguntas abiertas.
English
Build logs are maintained in build-log/. Each entry is a markdown file with a strict format. No retroactive editing. What was written on build day stays as written.
# YYYY-MM-DD -- Short title
## What was done
Description of work performed. Components installed, cables run,
firmware flashed, configuration applied.
## What broke
Failures encountered. Damaged components. Wiring errors.
Firmware issues. If nothing broke, the section says "Nothing."
## What worked
Successful outcomes. Measurements. Screenshots. Console output.
Verifiable evidence.
## Photos / Video
List of files in catalog/ with cross-reference.
| File | Description |
|------|-------------|
| YYYY-MM-DD-001.jpg | Image description |
## Notes
Observations, ideas for next session, open questions.
Espanol
Las decisiones tecnicas se registran en decisions/. Cada decision tiene su propio archivo.
# DEC-NNN -- Titulo de la decision
## Contexto
Que problema o necesidad motivo la decision.
## Opciones consideradas
1. Opcion A -- descripcion, pros, contras
2. Opcion B -- descripcion, pros, contras
3. Opcion C -- descripcion, pros, contras
## Decision
Cual opcion se eligio.
## Razonamiento
Por que se eligio esa opcion. Que criterios pesaron mas.
## Estado
Implementada / Pendiente / Revertida
English
Technical decisions are recorded in decisions/. Each decision has its own file.
# DEC-NNN -- Decision title
## Context
What problem or need motivated the decision.
## Options considered
1. Option A -- description, pros, cons
2. Option B -- description, pros, cons
3. Option C -- description, pros, cons
## Decision
Which option was chosen.
## Reasoning
Why that option was chosen. Which criteria weighed most.
## Status
Implemented / Pending / Reverted
Espanol
Fotos y video se almacenan en catalog/ y se indexan en catalog/INDEX.md. Los archivos binarios grandes (video, RAW) se rastrean con Git LFS o se enlazan a almacenamiento externo. Cada archivo tiene un nombre descriptivo con fecha como prefijo.
Convencion de nombres:
catalog/
+-- INDEX.md
+-- YYYY-MM-DD-rack-front.jpg
+-- YYYY-MM-DD-dgx-mounted.jpg
+-- YYYY-MM-DD-pi-shelf.mp4
+-- ...
Formato del indice:
| Archivo | Fecha | Contexto | Etiquetas |
|---|---|---|---|
| YYYY-MM-DD-descripcion.jpg | YYYY-MM-DD | Contexto breve | etiquetas |
English
Photos and video are stored in catalog/ and indexed in catalog/INDEX.md. Large binary files (video, RAW) are tracked with Git LFS or linked to external storage. Each file has a descriptive name with a date prefix.
Naming convention:
catalog/
+-- INDEX.md
+-- YYYY-MM-DD-rack-front.jpg
+-- YYYY-MM-DD-dgx-mounted.jpg
+-- YYYY-MM-DD-pi-shelf.mp4
+-- ...
Index format:
| File | Date | Context | Tags |
|---|---|---|---|
| YYYY-MM-DD-description.jpg | YYYY-MM-DD | Brief context | tags |
Espanol / English
studio/
+-- README.md
+-- LICENSE
+-- assets/
| +-- logo.png
+-- build-log/
| +-- YYYY-MM-DD-descripcion.md
| +-- ...
+-- decisions/
| +-- DEC-001-titulo.md
| +-- ...
+-- catalog/
| +-- INDEX.md
| +-- (fotos y video / photos and video)
+-- docs/
+-- rack-layout.md
+-- network-topology.md
Este trabajo esta licenciado bajo Creative Commons Attribution-ShareAlike 4.0 International. This work is licensed under Creative Commons Attribution-ShareAlike 4.0 International. See LICENSE.