iAlexeyRu

iAlexeyRu / miband-bot

Public

Telegram-бот для Xiaomi Fitness / Mi Band. Автономный импорт, SQLite и экспорт. | Self-hosted Mi Band health tracker bot.

ialexey.ru
11
1
85% credibility
Found May 25, 2026 at 41 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

miband-bot is a personal privacy-focused tool that creates your own Telegram bot to automatically fetch and store your Xiaomi Fitness and Mi Band health data (steps, sleep, heart rate, blood oxygen) on your own computer. Instead of relying on Xiaomi's app or cloud services, you get a simple dashboard in Telegram where you can view your daily stats, browse historical calendars, see trends over weeks or months, and export your data anytime. The bot runs quietly in the background, syncing every 15 minutes, and everything stays under your control—no third parties involved.

How It Works

1
💬 You hear about a private way to track your Mi Band

A friend tells you about a bot that keeps your fitness data on your own computer instead of in the cloud.

2
📱 You create your own Telegram bot

You message @BotFather in Telegram to create a new bot, and copy the secret key it gives you.

3
🖥️ You install the bot on your computer or server

You run a simple installer that sets everything up automatically using Docker or Python.

4
🔐 You connect your Xiaomi account with a QR code

The bot shows you a QR code that you scan with your Xiaomi Fitness app to securely link your account.

5
⏳ Your health data starts syncing automatically

The bot quietly fetches your steps, sleep, heart rate, and blood oxygen every 15 minutes in the background.

6
You check your data whenever you want
📅
Browse your calendar

See your activity and sleep history day by day with color-coded indicators.

📈
View trends and analytics

Check your weekly or monthly averages for steps, sleep quality, and heart rate.

💚 You have private, complete access to all your fitness data

Everything stays on your own computer, and you can export it anytime as a spreadsheet—no one else can see it.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 41 to 11 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is miband-bot?

A self-hosted Telegram bot that pulls health data from Xiaomi Fitness for Mi Band wearers and stores it locally. Instead of relying on the Xiaomi or Zepp apps, you get a private Telegram interface to query steps, sleep stages, heart rate, and blood oxygen. The bot runs as two Docker containers—one that periodically syncs data from Xiaomi's cloud, another that handles the Telegram menu and exports. Everything stays on your own server in SQLite, and you can export your data as CSV zip archives directly in chat.

Why is it gaining traction?

Privacy is the main draw. No third-party services, no cloud dependency for viewing your own data. The bot also supports fetching detailed sleep breakdown including heart rate and SpO2 samples per segment, which goes beyond what many alternatives offer. Setup is beginner-friendly with one-click installers for macOS, Linux, and Windows, and QR code login keeps the Xiaomi auth flow simple. The architecture is straightforward: a sync daemon plus a Telegram handler sharing a SQLite database with file-based locking.

Who should use this?

Mi Band owners who want direct Telegram access to their health history without relying on Xiaomi's app or sharing data with third parties. Privacy-conscious users who want local-only storage. Developers comfortable with Docker who want to self-host a personal health dashboard. Not suitable for multi-user setups—documentation explicitly states the project targets a single owner.

Verdict

The 0.8500000238418579% credibility score reflects a young, low-visibility project with 11 stars and no public test suite visible in the repository. The code quality looks reasonable with proper async patterns and retry logic, but working with reverse-engineered Xiaomi APIs carries inherent risk— Xiaomi can break things without warning. For personal use on a single account, this is a solid, well-documented option. Just know you're on your own if the API changes.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.