miband-bot/README.es-ES.md

miband-bot

Русский | English | Español

Bot de Telegram self-hosted para datos de Xiaomi Fitness y Mi Band.

Sincroniza pasos, sueño, pulso, SpO2, estrés, actividad diaria, peso y entrenamientos en archivos SQLite locales, y permite consultarlos o exportarlos desde Telegram. No utiliza servicios externos para tus datos.

Diseñado para un único propietario. No es un bot público ni un servicio médico.

Funciones

• Resúmenes diarios, historial, informes semanales, tendencias, estadísticas familiares y comparaciones.
• Inicio de sesión QR de Xiaomi y sincronización manual o programada.
• Exportación CSV/ZIP desde Telegram.
• Interfaz en inglés por defecto, con ruso y español disponibles en Settings.
• Runtime Bun/TypeScript y Docker Compose.

Inicio rápido

cp .env.example secrets.env
# Define TELEGRAM_BOT_TOKEN en secrets.env
bun install
bun run check
docker compose up -d --build

Los datos de ejecución se guardan en ./data/. Mantén privados secrets.env, data/, los tokens de Xiaomi, las bases SQLite y las exportaciones.

Desarrollo

bun install
bun run check
bun run dev

El servicio expone /healthz y /readyz en el puerto 8080.

Licencia

GNU GPL v3.0 o posterior.