mirror of
https://github.com/alexgetmancom/miband-bot.git
synced 2026-09-05 18:16:18 +03:00
Alex Getman
47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
# miband-bot
|
|
|
|
[Русский](README.ru.md) | [English](README.md) | 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](LICENSE).
|