HiMe

English | 简体中文

HiMe (Health Intelligence Management Engine) is a self-hosted, fully local, secure and open-source one-stop personal health AI agent platform. It understand your wearable health data in real-time and provide you with proactive insights 7/24, and of course, a cute pixel-art cat that serves as your personal health digital twin.

Features

• Real-time wearable data ingestion from Apple Watch + iPhone, including heart rate, HRV, SpO2, sleep stages, workouts, mobility, and 50+ metrics more.
• iOS and watchOS companion apps for easy syncing health data and controlling the agent.
• Native in-app chat — talk to the agent directly inside the iOS app: streaming replies, image sharing, evidence-backed answers, and proactive push (APNs) when the app is closed. No bot binding required.
• Personalised health plan — a quick onboarding goal survey, then the agent designs and schedules your recurring check-ins automatically (redesign anytime from Settings).
• Autonomous AI analysis with scheduled checks and event triggers, delivered as chart-rich (图文并茂) reports.
• Optional IM gateways — chat over Telegram, Feishu, or WeChat (via the official ClawBot plugin) instead of, or alongside, the in-app chat.
• Agent-generated personalised pages on demand for repeated workflows or personalised interaction. Generate your app, not learn to use it.
• Skills system for reusable analysis playbooks.
• Strong self-hosted privacy posture.

Quick Start

Three steps. Total time: ~10 minutes.

1. (Optional) Get IM credentials

Skip this if you'll use the built-in in-app chat — the iOS app talks to the agent directly, no bot needed. If you'd rather chat over an IM app, HiMe also supports Telegram, Feishu, or WeChat. Pick one and grab the credentials before you start the server (the setup wizard will ask for them).

• Telegram: create a bot with @BotFather → save the token. Send /start to @userinfobot → save your chat_id.
• Feishu: create a custom app at open.feishu.cn → grab APP_ID + APP_SECRET. Invite the bot to a group → grab the open_chat_id.
• WeChat: no developer console needed — set WEIXIN_GATEWAY_ENABLED=true in .env, then run python -m backend.weixin.qr_login (or docker exec -it hime-backend python -m backend.weixin.qr_login) and scan the QR with WeChat → Settings → Plugins → ClawBot.

Detailed walkthrough: docs/INSTALL.md#im-gateway-setup.

2. Start the server

git clone https://github.com/thinkwee/HiMe.git HiMe
cd HiMe
./setup.sh

Don't worry, just follow the quick start wizard in setup.sh and all the steps will be done for you. ~2-5 minutes for first build.

When it's done, the dashboard is at http://localhost:5173 — but you'll do most things through the iOS app.

3. Install the iOS app

• Easy path: install HiMe on the App Store. Open Settings → Server URL → enter your host (e.g. localhost, your Mac's LAN IP, or homelab.local).
• Build from source: see docs/INSTALL.md#ios-app.

That's it. Open the Chat tab in the app and message Hime — or message your IM bot if you set one up — and the agent will reply.

Update the HiMe

Pull the latest release and restart — your .env, data/, and memory/ are preserved:

git pull
./hime.sh restart --rebuild   # Docker mode: rebuilds images
./hime.sh restart --clean     # Native mode: clears Python/node caches

If a new release adds variables, diff .env.example against your .env and fill in any missing keys. See docs/DEPLOYMENT.md for backup guidance.

Documentation

• docs/INSTALL.md — manual setup, native dev install, public deployment, customization.
• docs/DEPLOYMENT.md — LAN, public-internet, and Compose production patterns.
• docs/DEVELOPMENT.md — architecture, adding tools/providers, code style.
• CONTRIBUTING.md — contribution process.
• SECURITY.md — security disclosure.
• PRIVACY.md — privacy policy.

Status

HiMe is research-grade software for personal use. It is not a medical device and does not provide diagnoses.

License

HiMe is released under the PolyForm Noncommercial License 1.0.0.

Trademark

"HiMe" and the HiMe logo are trademarks of the HiMe Organisation.