miband-bot

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

Личный self-hosted Telegram-бот для данных Xiaomi Fitness и Mi Band.

Он синхронизирует шаги, сон, пульс, SpO2, стресс, суточную активность, вес и тренировки в локальные SQLite-файлы, а смотреть и экспортировать их можно прямо из Telegram. Данные не уходят в сторонние сервисы.

Проект рассчитан на одного владельца. Это не публичный бот и не медицинский сервис.

Возможности

Сводки за день, история, недельные отчёты, тренды, семейная статистика и сравнения.
QR-вход Xiaomi и ручная или плановая синхронизация.
Экспорт CSV/ZIP из Telegram.
По умолчанию интерфейс на английском; русский и испанский включаются в Settings.
Bun/TypeScript runtime и Docker Compose.

Быстрый запуск

` cp .env.example secrets.env

Укажите TELEGRAM_BOT_TOKEN в secrets.env

bun install bun run check docker compose up -d --build `

Рабочие данные находятся в ./data. Файлы secrets.env, data/, токены Xiaomi, SQLite-базы и экспорты должны оставаться приватными.

Разработка

bun install bun run check bun run dev

Сервис открывает /healthz и /readyz на порту 8080.

Лицензия

GNU GPL v3.0 или новее.

1.8 KiB Raw Blame History