miband-bot

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

Self-hosted Telegram bot for Xiaomi Fitness and Mi Band health data.

It synchronizes steps, sleep, heart rate, SpO2, stress, daily activity, weight, and workouts into local SQLite files and lets you view or export them from Telegram. No third-party data service is involved.

Designed for one private owner. Not a public bot or a medical service.

Features

• Daily health summaries, history, weekly reports, trends, family stats, and comparisons.
• Xiaomi QR login and scheduled or manual synchronization.
• CSV/ZIP export from Telegram.
• English interface by default, with Russian and Spanish switchers in Settings.
• Bun/TypeScript runtime with Docker Compose.

Quick start

` cp .env.example secrets.env

Set TELEGRAM_BOT_TOKEN in secrets.env

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

Runtime data is stored in ./data. Keep secrets.env, data/, Xiaomi tokens, SQLite databases, and exports private.

Development

bun install bun run check bun run dev

The service exposes /healthz and /readyz on port 8080.

License

GNU GPL v3.0 or later.