miband-bot/README.ru.md

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 или новее.