HiMe

---

HiMe (Health Intelligence Management Engine) is a self-hosted, fully local, secure, and open-source one-stop personal health AI agent platform. It understands your wearable health data in real-time and provides you with proactive insights 7/24, and of course, a cute pixel-art cat that serves as your personal health digital twin. Download the app at https://apps.apple.com/app/himeapp/id6762160735

News 📢 Our paper is now on arXiv and accepted as an EMNLP 2026 demo paper! 🎉🎉🎉 Check it out at: HiMe: A Self-Hosted Personal Health AI Agent Platform. Give it a read to learn more about the system design and motivation behind HiMe.

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 of 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.
  • Multiple conversations: start, rename, archive or delete threads; the pinned Hime thread receives every scheduled report and reminder.
  • See the agent work: each reply is one stable block with a collapsible step list (thinking, data analysis, tool calls) above the streamed answer, a Stop button, and an animated pixel-cat avatar that reflects what the agent is doing.
  • A self-healing connection with heartbeat and auto-reconnect, so replies show up live instead of only as a notification.
• Web dashboard with light / dark / system themes and an Agent Monitor that groups every chat and background run into a readable timeline, with full history.
• 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.
• You like the Apple/Whoop Readiness and Health Age features? Just ask your HiMe agent to create one!

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.