repostats
Dashboard auto-alojado para estadísticas de repositorios GitHub (tráfico, clones, estrellas, descargas). Recopila y almacena datos históricos que la plataforma borra tras 14 días en un único archivo SQLite.
Ficha actualizada 25 sept 2026, 10:23 · upstream 25 sept 2026, 10:20 · release v1.0.1
Qué es repostats
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Repo Stats es una solución auto-alojada diseñada para recuperar las métricas que GitHub elimina automáticamente. La plataforma centraliza el tráfico web, los clones, las descargas de releases y las estrellas en un único archivo SQLite persistente, permitiendo análisis históricos sin depender de la interfaz oficial limitada a catorce días.
El proyecto utiliza FastAPI en Python y se despliega mediante Docker Compose en contenedores ligeros. Genera gráficos SVG directamente en el servidor, eliminando la necesidad de librerías de visualización externas o CDNs, lo que garantiza funcionamiento offline. Soporta arquitectura amd64 y arm64 sin compilación previa.
La configuración requiere autenticación mediante tokens de GitHub (fine-grained para tráfico y classic para estrellas) y una cuenta de usuario inicial definida en el navegador. Incluye integración específica con Home Assistant para rastrear instalaciones por versión.
- Visualización histórica del tráfico web y clones para repositorios públicos y privados.
- Auditoría de descargas de assets en releases para medir impacto real de actualizaciones.
- Monitoreo de integraciones de Home Assistant analizando instalaciones por versión.
- Seguimiento de métricas de CI/CD como tasa de éxito, duración y contribuyentes.
- Gestión centralizada de estadísticas para cuentas con múltiples repositorios.
- Persistencia de datos en SQLite: un único archivo permite copias de seguridad sencillas y recuperación ante fallos.
- Gráficos SVG generados en servidor: sin dependencias externas, funciona offline y carga rápido.
- Soporte nativo para arquitectura arm64 (Raspberry Pi) y amd64 mediante imágenes oficiales.
- Seguridad por separación de tokens: token clásico exclusivo para historial de estrellas evita comprometer el acceso principal.
- Sin telemetría ni verificación de actualizaciones: todo el tráfico sale solo hacia la API de GitHub.
- Recuperación automática tras paradas breves: la recolección diaria restaura la ventana de 14 días.
- Requiere tokens de GitHub con permisos específicos (scope public_repo para estrellas, read-admin para tráfico).
- Los datos privados solo son accesibles si el usuario autenticado es el propietario del repositorio.
- La configuración inicial exige definir nombre de usuario y contraseña en la primera visita al dashboard.
- El historial de estrellas depende de un token clásico separado que GitHub no permite con tokens fine-grained.
- No soporta análisis de métricas privadas sin autenticación explícita del propietario.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Desplegar mediante docker compose up -d. Configurar variables GITHUB_TOKEN y GITHUB_TOKEN_STARS en .env. Usar volumen para persistir /data/repostats.db. Si se usa reverse proxy, consultar docs/traefik.yaml.example. El puerto por defecto es 8377. Realizar backup periódico del archivo SQLite.
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.