Tabla de contenido
Una vez más aquí. Durante los últimos días me han pedido un pequeño proyecto con Streamlit, que viene siendo un framework de Python de código abierto, el cual permite crear aplicaciones web interactivas de forma rápida y sencilla, con unos resultados más que interesantes. Y como nunca había trabajado con esto, pues antes de ponerme a ello, hice un pequeño ejercicio para crear un pequeño control de entrenamiento a modo de prueba, al cual terminé llamando sudoraciones propias.
Hoy en día, y ya que la vida me va llevando por la programación, mover el culo de la silla de cuando en cuando no está demás, y por eso he realizado este pequeño programa. Sudoraciones propias representa una aplicación web de entrenamiento personal desarrollada íntegramente en Python usando Streamlit, que combina la potencia de la programación moderna con metodologías de entrenamiento, que seguro que alguien habrá probado.
Este sistema de entrenamiento inteligente está diseñado pensando en personas que buscan maximizar sus resultados físicos desde casa, utilizando equipamiento básico pero con la precisión y seguimiento de un entrenador personal profesional. Con más de 22 ejercicios especializados y un sistema de progresión automática de 20 semanas, Sudoraciones propias es otra opción de las muchas que ya existen para poder entrenar en casa con un poco de lógica.
¿Qué es sudoraciones propias? Definición y características principales
Como decía líneas más arriba, este es un programa de entrenamiento personalizado desarrollado como una aplicación web interactiva que funciona completamente en el navegador web. Esta herramienta de fitness digital está construida con una arquitectura modular en Python, utilizando las últimas versiones de Streamlit 1.47.1 y Python 3.12.
Características técnicas destacadas:
- 22 ejercicios especializados distribuidos en 8 grupos musculares
- Sistema de progresión inteligente con 4 niveles de dificultad
- Seguimiento automático del progreso con métricas avanzadas
- Videos YouTube integrados para cada ejercicio
- Calendario visual inteligente con porcentajes de completado
- Interfaz completamente en español optimizada para usuarios hispanohablantes
Tecnologías y frameworks utilizados
El desarrollo de SUDORACIONES se basa en una stack tecnológico moderno que garantiza rendimiento, escalabilidad y facilidad de uso:
Backend y lógica de negocio
- Python 3.12: Lenguaje principal con todas las ventajas de las últimas características
- Streamlit 1.47.1: Framework para aplicaciones web interactivas
- JSON: Sistema de configuración dinámica para ejercicios y planes
- Pandas: Manejo de datos y estadísticas de progreso
- Plotly: Generación de gráficos interactivos para análisis
Arquitectura modular avanzada
La aplicación utiliza una arquitectura modular de 6 componentes especializados:
- base_trainer.py: Funcionalidad core del sistema y gestión de configuración
- training_plan.py: Algoritmos de generación automática de entrenamientos
- progress_calendar.py: Lógica del calendario y cálculo de porcentajes
- statistics.py: Motor de análisis y generación de métricas
- info.py: Sistema de información y documentación integrada
- main_app.py: Interfaz principal y coordinación de módulos
Sistema de configuración inteligente
El corazón técnico de SUDORACIONES reside en su sistema de configuración JSON dinámico:
{
"exercises": {
"brazos": [
{
"name": "Curl Martillo",
"equipment": "dumbbells_10kg",
"sets": 1,
"reps": "8-10",
"description": "Curl con agarre neutro para braquial",
"youtube_url": "URL_del_video"
}
]
}
}Esta estructura permite escalabilidad infinita y personalización completa sin modificar código fuente.
Metodología de entrenamiento: sistema de progresión científico
tectake® multiestación musculación, máquina de musculación multifuncional con polea gimnasio mariposa, barra de ejercicios, entrenamiento en casa, gimnasio en casa, multiestación gimnasio – Negro
DH FitLife Power Tower Estación de Dominadas Plegable Multifuncional, Gimnasio en Casa, Altura Ajustable, Para Pull Up, Sentadillas, Entrenamiento de Fuerza y Calistenia : Amazon.es: Deportes y aire libre
Dskeuzeew Power Tower Dip Station Estación de fondos,as para Gimnasio en casa, Estación de Entrenamiento Maquina Dominadas Multifuncional Max 150 kg : Amazon.es: Deportes y aire libre
Principios fundamentales del sistema
Sudoraciones propias intenta basarse en principios científicos de entrenamiento validados por la investigación en ciencias del deporte:
1. Progresión inteligente por niveles
El sistema implementa un algoritmo de progresión automática que ajusta la intensidad y frecuencia basándose en 4 niveles:
- Nivel 1 (Principiante): 4 entrenamientos semanales – Adaptación neuronal
- Nivel 2 (Intermedio): 5 entrenamientos semanales – Incremento de frecuencia
- Nivel 3 (Avanzado): 5 entrenamientos intensificados – Aumento de volumen
- Nivel 4+ (Experto): 6 entrenamientos semanales – Máxima intensidad
2. Periodización Inteligente
Cada nivel tiene una duración de 4 semanas, siguiendo los principios de periodización lineal que maximizan las adaptaciones fisiológicas mientras previenen el sobreentrenamiento.
3. Distribución muscular optimizada
Los 22 ejercicios están distribuidos en los siguientes grupos musculares
- Pecho: 5 ejercicios (23% del total)
- Brazos: 4 ejercicios (18% del total)
- Abdominales: 4 ejercicios (18% del total)
- Piernas: 2 ejercicios (9% del total)
- Espalda, Hombros, Gemelos, Cardio: 7 ejercicios combinados (32% del total)
Guía de uso completo
Instalación y configuración inicial
Requisitos del sistema
- Python 3.12+ instalado en el sistema
- Navegador web moderno (Chrome, Firefox, Safari, Edge)
- Conexión a internet para videos de YouTube
- 4GB RAM mínimo para óptimo rendimiento
Proceso de Instalación paso a paso
1. Descarga del Sistema:
git clone https://github.com/sapoclay/sudoraciones-propias.git cd sudoraciones-propias
2. Instalación Automática:
python3 run_app.py
El sistema crea automáticamente el entorno virtual, instala dependencias y configura la aplicación.
3. Acceso a la Aplicación:
• URL Local: http://localhost:8508
• URL Externa: http://0.0.0.0:8508
Instalación mediante paquete .DEB
Si prefieres instalar este programa como paquete .deb, el usuario puede descargar este paquete desde la página de lanzamientos del proyecto.
Una vez descargado, basta con abrir una terminal (Ctrl+Alt+T) y escribir en la misma carpeta en la que esté guardado el paquete .deb:
sudo dpkg -i sudoraciones_1.0.0_amd64.deb
En caso de que aparezcan problemas con las dependencias (que no debería, pero nunca se sabe), basta con escribir en la misma terminal:
sudo apt-get install -f
Una vez terminada la instalación, ya se puede buscar el lanzador en nuestro equipo:
El icono permitirá al usuario iniciar, parar o reiniciar el programa haciendo clic con el botón derecho del ratón sobre el icono del programa.
Navegación y funcionalidades principales
Panel de control principal
La interfaz está dividida en 4 pestañas especializadas:
1. Plan de Entrenamiento: Ejercicios del día actual con videos integrados
2. Progreso: Calendario visual y estadísticas de completado
3. Estadísticas: Gráficos avanzados y métricas de rendimiento
4. Información: Documentación completa y guías de uso
Sistema de seguimiento inteligente
El algoritmo de seguimiento considera un día completado cuando se realiza el 80% de los ejercicios, proporcionando flexibilidad realista mientras mantiene la exigencia.
Personalización avanzada
- Configuración de videos: El usuario puede establecer URLs personalizables para cada ejercicio
- Opciones de visualización: Control granular de interface elements
- Gestión de progreso: Funciones de reinicio y backup
Beneficios únicos del sistema sudoraciones propias
PASYOU Banco de pesas plegable con posiciones ajustables de 9 x 4 x 3 cm, multi banco inclinado como abdominal y espalda para el hogar, carga máxima de 318 kg : Amazon.es: Deportes y aire libre
CAP Pesos hexagonales recubiertos de 35 libras, nueva edición
Para principiantes
- Progresión suave: Inicio con 4 días semanales para evitar agotamiento
- Videos instructivos: Técnica correcta desde el primer día
- Seguimiento motivacional: Visualización clara del progreso
Usuarios intermedios
- Desafío progresivo: Incremento automático de intensidad
- Variedad inteligente: 22 ejercicios rotan para evitar monotonía
- Métricas detalladas: Análisis profundo del rendimiento
Avanzados
- Intensidad máxima: Hasta 6 entrenamientos semanales
- Personalización total: Configuración avanzada de rutinas
- Sostenibilidad: Programa de 20 semanas sin estancamiento
Para desarrolladores y entusiastas de Python
Como decía al comienzo de este artículo, esto no es más que un pequeño ejercicio para empaparme un poco de cómo trabajar con Streamlit, por eso este pequeño proyecto es de código abierto, con una arquitectura modular fácilmente extensible. Incluye documentación completa, creo que vienen siendo más de 2000 líneas de código documentado para terminar siendo un ejemplo de cómo funciona la aplicación Streamlit.
Equipamiento necesario: Inversión mínima
Sudoraciones propias está optimizado para equipamiento doméstico básico. Ya que no todo el mundo tiene tiempo para desplazarse a dejarse las sudoraciones en un gimnasio a tomar viento de casa. Por este motivo la idea es poder entrenar un poco sin gastar prácticamente nada::
Equipamiento esencial
- 2 Mancuernas de 10kg: Para la mayoría de ejercicios
- 1 Mancuerna de 12kg: Para ejercicios de fuerza específicos
- 1 Banco de entrenamiento: Con capacidad para 30kg
- Bicicleta estática: Para componente cardiovascular
- Espacio libre: 2×2 metros para ejercicios en suelo
Resultados esperados y cronograma de progreso
Principiante – Semanas 1-4
- Adaptación neuronal: Mejora en coordinación y técnica
- Establishment de rutina: Creación de hábitos sostenibles
- Resistencia básica: Incremento en capacidad cardiovascular
Intermedio – Semanas 5-8
- Hipertrofia inicial: Primeros signos de desarrollo muscular
- Fuerza funcional: Incremento notable en capacidades
- Confianza técnica: Dominio de movimientos complejos
Avanzado – Semanas 9-12
- Definición muscular: Cambios visibles en composición corporal
- Resistencia avanzada: Capacidad para entrenamientos intensos
- Técnica refinada: Ejecución perfecta de todos los ejercicios
Experto – Semanas 13-20
- Transformación completa: Resultados físicos significativos
- Capacidades de élite: Fuerza y resistencia superiores
- Hábitos consolidados: Estilo de vida más sano permanentemente
Ventajas competitivas y diferenciación frente
Como suele ocurrir con la gran mayoría de los proyectos en lo que me meto, busco minimizar gastos e intentar que estén disponibles para todos. Por eso en este caso en particular, la idea es buscar ciertas ventajas frente a:
A aplicaciones comerciales
- Gratuito y de código abierto: Sin suscripciones ni pagos ocultos
- Personalización total: Modificable según necesidades específicas (solo hay que saber un poco de Python)
- Privacidad garantizada: Datos almacenados localmente
- Sin dependencias externas: Funciona completamente offline (excepto videos)
Entrenadores personales
- Disponibilidad 24/7: Entrena cuando quieras
- Costo cero: Sin pagos mensuales o por sesión
- Progresión: Se puede realizar un seguimiento de la progresión de los entrenamiento de forma gráfica y sencilla
- Seguimiento automático: Métricas sin esfuerzo manual
Gimnasios tradicionales
- Conveniencia doméstica: Sin desplazamientos ni horarios
- Equipamiento mínimo: Inversión única y pequeña
- Ambiente controlado: Sin intimidación social
- Higiene garantizada: Equipamiento personal y limpio
Conclusión
Sudoraciones propias representa una práctica de Python que puede resultar útil si buscas un entrenamiento personal doméstico. Este programa combina la potencia de Python con metodologías de fitness. La inversión mínima en equipamiento, la ausencia total de costos recurrentes y la flexibilidad de personalización completa hacen de sudoraciones propias la opción ideal para cualquier persona seria sobre alcanzar sus objetivos de fitness desde casa.
Comienza tu transformación con sudoraciones propias en 20 semanas de entrenamiento diseñado, completamente gratis y para siempre.
Se puede descargar todo el código completo de este proyecto desde el repositorio en GitHub en el que he alojado este proyecto.