Gyme
Gyme es una plataforma open-source de gestión para gimnasios y entrenadores personales. Utiliza FastAPI y PocketBase para ofrecer una aplicación web multi-inquilino con branding personalizado. Incluye planes de entrenamiento, seguimiento de progreso y PWA para móviles.
Ficha actualizada 26 sept 2026, 14:52 · upstream 26 sept 2026, 14:36 · release v0.9.1
Qué es Gyme
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Gyme es software open-source auto-alojado diseñado para gestionar gimnasios, entrenadores y alumnos. Permite a los dueños administrar equipos, crear planes de entrenamiento, nutrición y suplementación, mientras que los alumnos siguen sus rutinas diarias desde un dispositivo móvil. La plataforma soporta múltiples idiomas, incluyendo español, turco y armenio, además del inglés por defecto.
Técnicamente, la aplicación se basa en FastAPI para el backend y PocketBase como base de datos externa para almacenamiento de registros y autenticación. El frontend es una PWA construida con HTMX, Alpine.js y Jinja2, permitiendo interactividad sin recargas completas y soporte offline mediante caché de service worker. Cada gimnasio se resuelve por hostname, ofreciendo un entorno aislado con logo y manifest dinámicos.
Las funcionalidades clave incluyen la gestión de roles (dueño, entrenador, alumno), cálculo automático de métricas corporales como IMC y grasa corporal, y plantillas reutilizables para planes. La arquitectura separa la lógica de negocio en servicios y las rutas HTTP, facilitando el mantenimiento y la seguridad mediante middleware de tenencia y autenticación.
- Gestión integral de gimnasios con branding único por instalación
- Creación y asignación de planes de entrenamiento y dieta a alumnos
- Seguimiento de progreso físico con métricas automáticas y fotos
- Acceso móvil offline para los entrenados mediante PWA
- Auditoría de seguridad con roles restringidos por entrenador
- Internacionalización nativa para equipos multilingües
- Arquitectura multi-inquilino basada en resolución de hostname
- Integración robusta con PocketBase para backend y almacenamiento
- Frontend PWA con soporte offline y branding personalizado por gimnasio
- Internacionalización nativa (inglés, español, turco, armenio)
- Automatización de cálculos de métricas corporales (BMI, BFP, etc.)
- Suite de pruebas automatizada con CI/CD y seguridad verificada
- Contraseñas aleatorias no mostradas en la UI al crear cuentas nuevas
- Límite de tasa solo aplicado a login, no a cambio de contraseña
- Requiere PocketBase externo instalado y configurado previamente
- No incluye Docker Compose, solo Dockerfile para contenedorización
- Variables de entorno deben exportarse manualmente (sin carga automática de .env)
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue con Docker requiere construir assets estáticos primero usando Node/Vite antes de crear la imagen. Se debe configurar PB_URL apuntando a la instancia PocketBase y establecer ALLOWED_HOSTS en producción para evitar advertencias. El acceso se realiza mediante un hostname que coincide con un registro en la colección tenants de PocketBase. La versión más reciente se encuentra en GHCR bajo la etiqueta latest o tags específicos como v0.9.1.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.