MetaCoach — El entrenador que ningun app ha construido
MetaCoach resuelve el problema que ninguna app de fitness ha resuelto bien: la personalización fisiológica real. No un plan estándar con tu peso y altura. Un plan que cambia cada semana según cómo respondió TU cuerpo concreto: tu sueño, tu HRV, tus analíticas de sangre, tu carga de entrenamiento acumulada.
Cómo funciona
El agente LangChain analiza tus datos fisiológicos con 3 herramientas en paralelo:
- Análisis wearable: HRV, sueño, FC reposo, pasos. Si tu HRV baja 3 días consecutivos → reduce intensidad sin preguntar
- Análisis de analíticas: Detecta ferritina baja (afecta transporte de oxígeno), vitamina D deficiente, glucosa elevada → ajusta plan nutricional
- Generación de plan: LLaMA 3.1 genera plan semanal personalizado con entrenamiento + nutrición + suplementación basados en todos los datos
Stack técnico
- LangChain + Groq/LLaMA 3.3 70B: agente con herramientas para análisis fisiológico
- Sistema de alertas fisiológicas: reglas basadas en rangos clínicos reales (OMS, ACSM)
- ConversationSummaryBufferMemory: el coach recuerda el contexto de tu plan en el chat
- FastAPI + Uvicorn: API asíncrona de alta velocidad
Integración, datos y licencia
- Integración: API REST propia (FastAPI) con 6 endpoints documentados en el repositorio; se puede consumir desde cualquier lenguaje o plataforma, con especificación OpenAPI autogenerada.
- Tratamiento de datos: la demo pública envía a Groq (LLaMA) únicamente el contenido necesario para generar la respuesta. No se almacenan las conversaciones en base de datos ni se asocian a ninguna identidad. En un despliegue propio decides tú el proveedor — incluido un modelo local, con el que ningún dato sale de tu infraestructura.
- Licencia: MIT — uso libre, incluido comercial, manteniendo el aviso de copyright. El repositorio contiene la aplicación completa y puede desplegarse en infraestructura propia. El código es gratuito; los costes de motor de IA, infraestructura, implantación y mantenimiento corren por cuenta de quien lo despliega (no se ofrece soporte ni consultoría).
¿Cómo lo integro?
Disponible ahora: API REST que genera planes de entrenamiento a partir del perfil enviado; se puede llamar desde una app móvil o un panel web.
Integraciones habituales en este sector (valoradas como vía recomendada; salvo que se indique lo contrario, no vienen implementadas — el código está preparado para añadirlas):
- Strava API (v3, OAuth2): la integración más valiosa: leer las actividades reales del usuario para ajustar el plan a lo que de verdad entrena, no a lo que dice que entrena.
- Garmin Health / Fitbit Web API: datos de sueño, frecuencia cardíaca en reposo y carga — las variables que de verdad determinan si toca subir o bajar intensidad.
- Apple HealthKit / Google Fit: vía app móvil, para usuarios sin dispositivo de una marca concreta.
- Formatos TCX / GPX — YA IMPLEMENTADO:
POST /metacoach/import/activity acepta el fichero que exporta cualquier reloj (Garmin, Polar, Suunto, Coros, Wahoo, Strava, Apple Salud) y extrae deporte, duración, distancia, calorías y pulso. La respuesta distingue lo que el fichero contiene de verdad de lo que no puede aportar (sueño, HRV, pulso en reposo), en vez de rellenarlo con valores inventados.