🎯 El problema: consejo genérico × tus datos
Pregúntale a un chatbot común "¿debería tomar café ahora?" y te responderá con una promedio de Internet: "evita después de las 14h". La respuesta es igual para todos: no sabe cómo dormiste, qué hora es para tu cuerpo ni cómo metabolizas la cafeína. HealthOS reemplaza ese promedio por una respuesta basada en tú.
✗ Consejo genérico
- ✗"Duerme 8 horas" — sin saber cuánto dormiste AYER.
- ✗"Come menos sal" — sin ver que tu presión sube 10-15% después de un almuerzo salado.
- ✗Lo olvida todo en la próxima conversación. Sin memoria, sin patrones.
✓ Coaching con tus datos
- ✓"Recovery 48% hoy — probablemente el vino de ayer influyó. Tómalo con calma."
- ✓"Metabolizas la cafeína rápido (CYP1A2): café temprano, déjalo por la tarde."
- ✓Recuerda semanas atrás: «cada vez que cenas tarde, duermes menos».
💡 La idea en una frase
Lo específico supera a lo genérico. Un coach basado en tus exámenes, genética y metas te da consejos consciente del mecanismo (sabe el «porqué» en tu cuerpo); un bot genérico da respuestas vacías. Todo el diseño de HealthOS fuerza esa especificidad.
Conceptos clave
Respuesta basada en tus cifras, no en el promedio.
Recuerda el historial y detecta patrones a lo largo de las semanas.
Explica la causa en tu cuerpo, no solo la recomendación.
Wearable + sangre + ADN + dieta, juntos.
🫀 Qué es exactamente HealthOS
El HealthOS es un blueprint completo (un proyecto modelo, listo para clonar) de un coach de salud personal que vive en un bot de Telegram. Conversas con él por mensaje; por detrás, guarda todo en una base de datos solo tuya, lee tu wearable y responde siempre a partir de tu contexto actual.
🟢 ¿Nuevo por aquí? Tres palabras antes de continuar
- LLM — es el modelo de IA del tipo que funciona detrás de ChatGPT/Claude. Es el "cerebro" que lee tus datos y redacta la respuesta.
- Coach (agente) — aquí no es solo un chat: es un agente, un programa que actúa por su cuenta (busca tus datos, escribe en la base de datos, activa la revisión de la mañana), además de conversar.
- Consciente del mecanismo — «consciente del mecanismo»: en vez de solo decirte «toma menos café», conoce la razón fisiológica en TI (ej.: tu gen de la cafeína) y actúa en función de ella.
📦 Qué incluye el paquete
- •Uno coach en Telegram basado en tus datos, no en consejos genéricos.
- •Uno base de datos propia (Supabase) con comida, entrenamiento, peso, cafeína, suplementos, signos vitales, análisis, registros de seguimiento y metas, además de la memoria de los mensajes.
- •Una conexión con el wearable (WHOOP en el ejemplo) de principio a fin: autorización, sincronización diaria y mapeo de los datos.
- •Una revisión de la mañana guiada por la recuperación y un dashboard con las tendencias.
🧭 Dónde se ejecuta
Tú indicas tu Claude Code o Codex al repositorio y construye el tuyo. El ejemplo usa WHOOP, pero sirve cualquier fuente (Apple Watch, Garmin o registro manual) — el coach trabaja con lo que llegue a la base de datos. El autor lo probó en vivo durante más de 15 días antes de publicarlo.
Conceptos clave
Proyecto modelo listo para clonar y personalizar.
La interfaz: hablas por mensaje.
Tus datos en un Supabase privado tuyo.
Actúa por su cuenta, no solo responde.
🧩 Las 4 fuentes de datos
La fuerza del coach viene de cruzar cuatro fuentes que normalmente están en apps separadas. Por sí sola, cada una es una pieza; juntas, se convierten en contexto. El diagrama de abajo muestra cómo las cuatro convergen en un único coach.
📊 Cómo leer: las cuatro fuentes (cian, a la izquierda) entran en el coach, que las combina y devuelve un consejo específico (verde). Ninguna fuente por sí sola bastaría — el valor está en el cruce.
⌚ Wearable
Recuperación, variabilidad cardíaca, frecuencia en reposo y horas de sueño. Es el "cómo despertó el cuerpo hoy".
🩸 Sangre
Marcadores como ApoB, HOMA-IR, vitamina D. La foto bioquímica de tu metabolismo y riesgo.
🧬 ADN
SNP (variantes genéticas) que ajustan las dosis: cafeína, grasas saturadas, vitamina D, sal. Genes como botones.
🍽️ Dieta
Foto de la comida → macros estimados mediante visión. Cierra el vínculo entre lo que comes y cómo te recuperas.
Conceptos clave
Cómo amaneció el cuerpo hoy.
La bioquímica del metabolismo.
Ajusta las dosis — genes como botones.
El valor está en combinar las cuatro.
🏗️ La arquitectura a alto nivel
Cada vez que envías un mensaje, ocurre la misma secuencia: el agente lee un snapshot (un resumen compacto de tu estado actual) de la base de datos, razona con el LLM fundamentado en tus datos y responde. Sigue el flujo en el diagrama.
🟢 ¿Nuevo por aquí?
- Supabase — es una base de datos en la nube (PostgreSQL) con almacenamiento de archivos. Ahí están TODOS tus datos de salud, en un proyecto privado solo tuyo.
- Snapshot de sesión — una imagen compacta del «ahora»: tendencia del peso, lo que comiste hoy, presión, la recuperación de ayer, el patrón de sueño de 7 días y tus metas. El agente la lee al comienzo de cada conversación para responder siempre con el contexto actual.
📊 Cómo leer: de izquierda a derecha está el recorrido de la pregunta; la línea discontinua es la respuesta de vuelta. El agente nunca "adivina": siempre lee la instantánea de la base de datos antes de razonar.
🧠 La memoria es el producto
Todo se escribe en líneas estructuradas en la base de datos. Por eso el coach conoce todo tu historial y detecta patrones a lo largo de las semanas; no solo reacciona al último mensaje. Guardamos estos módulos en detalle en la Ruta 1 (señales y memoria) y en la Ruta 2 (la base de datos).
Conceptos clave
Retrato compacto del "ahora", leído en cada turno.
Orquesta: lee, razona, escribe, responde.
La base de datos privada donde se guarda todo.
Líneas estructuradas = patrones a lo largo del tiempo.
🌅 Un día en la vida del coach
Todo el día transcurre en Telegram. El ejemplo de abajo es ilustrativo (números ficticios, no es un consejo): muestra cómo se cierra el ciclo: la elección de hoy se convierte en la recuperación de mañana.
📊 Cómo leer: la recuperación de hoy da inicio al día; las elecciones quedan registradas; la recuperación de mañana refleja esas elecciones. Este ciclo es la columna vertebral de HealthOS: te enseña cuáles son tus propios botones.
food_log)Conceptos clave
El número de la mañana decide si esforzarte o descansar.
La elección de hoy se convierte en la recuperación de mañana.
Cada elección se convierte en una fila en la base de datos.
Aprendes qué influye en tu cuerpo.
🔒 Privacidad y seguridad
Los datos de salud son sensibles. HealthOS es bloqueado por defecto: proyecto privado, acceso desde el servidor, secretos fuera de git. Nada sale, excepto las llamadas al LLM que decidas hacer.
🟢 ¿Nuevo por aquí?
RLS (Row-Level Security) — «seguridad a nivel de fila». Es una función de la base de datos que decide quién puede leer cada fila. En HealthOS, la RLS permanece activada sin ninguna política: la clave pública (anon) no puede leer nada, y solo el servidor (con la clave service-role) tiene acceso. Resultado: nadie de afuera puede leer tus datos.
✓ Qué garantiza el diseño
- ✓Proyecto Supabase privado, en tu cuenta.
- ✓RLS activada, sin políticas: la clave anon no puede leer nada.
- ✓Secretos en
~/.env(tu home), nunca en git.
✗ Lo que nunca debes versionar
- ✗Tu
CLAUDE.mdcompletado (perfil real). - ✗Los valores reales del seed y sus fotos.
- ✗El archivo
~/.envcon las claves.
Conceptos clave
La base de datos es tuya, en tu cuenta.
Nadie de fuera lee tus registros.
En ~/.env, fuera del control de versiones.
No sale nada más que lo que tú eliges.
⚠️ No es consejo médico · costo y requisitos previos
Antes de cualquier cosa técnica, la regla más importante de todo el curso: esto es una herramienta de registro y razonamiento, no un médico.
⚠️ No es consejo médico
- •Es el ejemplo de una persona, que consultó a médicos en cada paso. No es una prescripción para ti.
- •La IA puede alucinar. Trata toda sugerencia como una pregunta para consultar con el médico, nunca como una orden.
- •El coach recibe instrucciones para no diagnosticar ni modificar la medicación; te deriva a un profesional clínico.
- •Las muestras de ADN enviadas por correo se degradan; el panel de la clínica y el de Ancestry pueden no coincidir.
💰 Cuánto cuesta ejecutarlo
- Supabase — el plan gratuito alcanza para una persona.
- LLM + embeddings — las llamadas que haces (centavos para embeddings; ~US$10-20/mes de uso típico).
- Visión (Gemini) — centavos por foto.
- WHOOP — la API es gratuita con la suscripción. ¿No tienes WHOOP? Usa otro wearable o un registro manual.
🧰 Qué vas a necesitar (visión general)
Python 3.9+, Node, una cuenta de Supabase, un bot de Telegram y claves de API (OpenAI, Gemini y, opcionalmente, WHOOP). No te preocupes por tenerlo todo ahora: la Ruta 2 (Paso a paso) arma cada pieza contigo, desde cero.
Conceptos clave
Verifica todo con un médico.
Plan gratuito + ~US$10-20/mes.
Cualquier fuente sirve.
Los requisitos previos se indican en el paso a paso.
✅ Autoevaluación (opcional): ¿qué hace que HealthOS sea diferente de un chatbot común?
📋 Resumen del módulo
Próximo módulo:
1.2 — Las señales del cuerpo: recovery, HRV, RHR, sueño y los marcadores sanguíneos que lee el coach.