mirror of
https://github.com/alexgetmancom/miband-bot.git
synced 2026-09-05 18:16:18 +03:00
Alex Getman
47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
# miband-bot
|
|
|
|
[Русский](README.ru.md) | [English](README.md) | [Español](README.es-ES.md)
|
|
|
|
Личный 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 или новее](LICENSE).
|