Sacando el máximo partido a los registros de entrenamiento con LiftShift
Si vas al gimnasio y registras cuidadosamente cada serie en Hevy, Strong o Lyfta, probablemente habrás notado algo. Los rastreadores móviles son geniales para recopilar datos en bruto, pero casi nunca te ayudan a darles sentido. En el mejor de los casos, la aplicación muestra una gráfica de un ejercicio durante un mes y te felicita por un nuevo máximo de una repetición. El verdadero problema es que es difícil ver qué grupos musculares estás entrenando insuficientemente de forma consistente, dónde has alcanzado un verdadero estancamiento y necesitas cambiar tu enfoque, y qué es simplemente fatiga normal de la tercera serie.
Descubrí recientemente el proyecto de código abierto LiftShift. Es una herramienta web para el análisis profundo de registros de entrenamiento que se ejecuta directamente en el navegador y no requiere registro.
Qué puede hacer el proyecto
La idea central es simple: le proporcionas a la aplicación tu exportación o conectas tu cuenta, y organiza tus entrenamientos desde una perspectiva de periodización deportiva.
Estas son las cosas que destacan inmediatamente al explorar el panel:
- Mapa de calor muscular. Un modelo corporal interactivo muestra la carga de volumen en cada grupo muscular. Puedes hacer clic en un músculo específico y ver los ejercicios que produjeron ese estímulo. El algoritmo calcula las zonas de volumen (umbrales MEV y MRV) ajustados según la experiencia en entrenamiento y asigna una puntuación de hipertrofia de 0 a 100.
- Detección de estancamientos. En lugar de una simple tendencia de peso, la herramienta asigna estados claros a los ejercicios: crecimiento, meseta o decline. El sistema distingue entre estancamientos sin salida (cuando el peso y las repeticiones se han detenido por completo) y fluctuaciones en forma de onda, y luego sugiere una solución: añadir una repetición, reducir el peso de trabajo durante una semana de descarga, o cambiar el rango de repeticiones.
- Desglose de cada serie. Puedes abrir cualquier sesión pasada y ver las evaluaciones de las series. El sistema identifica fatiga normal, saltos de peso demasiado abruptos, series de descenso bien ejecutadas, o series hasta el fallo (AMRAP). Cada serie recibe una insignia y consejos directos para tu próximo entrenamiento.
- Combinación de datos de diferentes aplicaciones. Si has estado usando Strong durante años y luego cambiaste a Hevy, tu historial generalmente se fragmenta. El proyecto puede hacer coincidir diferentes nombres para los mismos ejercicios, eliminar duplicados y unir todo en una única línea temporal.
- Exportación para redes neuronales. Si las gráficas integradas no son suficientes, los datos se exportan en un formato estructurado para prompts a ChatGPT o Claude. Hay módulos listos para usar: auditoría de volumen inútil, verificación de equilibrio lateral o evaluación de carga articular.
- Mapa de calor estilo GitHub. Puedes ver claramente rachas, semanas perdidas y consistencia durante todo el año.
Bajo el capó
La arquitectura del proyecto está centrada en la privacidad. Todos los cálculos, el análisis de CSV y la renderización de gráficas ocurren del lado del cliente.
El frontend está construido con un stack moderno: React 19, TypeScript, Vite, Tailwind CSS y la biblioteca Recharts para visualización de datos. Un pequeño backend de Node.js con Express y Puppeteer se usa exclusivamente como proxy para llamadas a la API de rastreadores como Hevy y Lyfta, donde se requieren restricciones CORS del navegador o autorización. Los registros de entrenamiento no terminan almacenados en el servidor.
Para trabajar con Strong, se admiten importaciones de archivos CSV con delimitadores de punto y coma, comillas y sufijos de unidades de peso en los encabezados.
Cómo ejecutar localmente
Si quieres desplegar el proyecto en tu máquina o escribir un analizador personalizado, solo necesitas un par de comandos. Necesitarás Node.js versión 22 o superior.
git clone https://github.com/aree6/LiftShift.git
cd LiftShift
npm install
npm run dev
Después del inicio, el servidor local se abrirá en el puerto estándar de Vite.
Si estás usando la versión pública en el sitio web del proyecto, simplemente selecciona tu plataforma, sube un CSV o pega tu clave API, especifica tus unidades (kg o libras) y dirígete al panel.
Un pequeño detalle: al exportar desde Hevy, a veces la aplicación se queja de los formatos de fecha. Esto sucede debido a la configuración regional que no es inglés en la aplicación de origen. Simplemente cambia el idioma de exportación a inglés temporalmente:
Para quién es el proyecto
LiftShift llena perfectamente el vacío entre los cuadernos de gimnasio simples y las hojas de cálculo complejas de los entrenadores en Excel. Si eres demasiado perezoso para calcular manualmente el tonelaje por grupo muscular y buscar desequilibrios, el cliente web lo hace en un par de segundos.
El proyecto se distribuye bajo la licencia AGPL-3.0. La base de código es limpia, escrita en TypeScript estricto, así que si quieres añadir soporte para tu rastreador de fitness favorito o implementar nuevas métricas de periodización, contribuir aquí es bastante agradable.
Proyectos relacionados