Delx Wellness for Hermes

Delx Wellness for Hermes — One-command local-first wellness profile pack

Turn Hermes into your personal wellness agent in one command.
WHOOP · Oura · Garmin · Strava · Fitbit · Google Health · Withings · Apple Health · Samsung Health · Polar · Nutrition — all local, all read-only.

npm version npm downloads License MIT Site

Connector registry Built for MCP Runs on Hermes GitHub stars

What is this? A one-command installer and daily wellness operator that wires 15 wellness MCP connectors + a recovery-aware SOUL.md + onboarding + skills into a dedicated Hermes profile. No fork, no hosted vault, no token leaves your machine.

🎯 Agent-readiness audited — the wearable connectors score 90–97/100 on mcp-scorecard's 10 checks. See the scored registry.

Delx Wellness Hermes profile workflow demo

--- ## ⚡ Quick Start If Hermes is already installed: ```bash npx -y delx-wellness-hermes setup hermes -p delx-wellness -z "$(npx -y delx-wellness-hermes operator --prompt-only)" ``` That's it. The installer creates `~/.hermes/profiles/delx-wellness`, installs the wellness skills, wires the 11 default connectors (the other 4 opt-in providers are one flag away — see [Demo](#-demo)), runs a smoke test against Nourish (no OAuth required), and prints the next commands for model setup and per-provider auth. If this profile does not have a model configured yet: ```bash hermes -p delx-wellness model npx -y delx-wellness-hermes doctor --profile delx-wellness --run-hermes --test-chat ``` If you are new to Hermes, install Hermes first: ```bash curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-setup npx -y delx-wellness-hermes setup hermes -p delx-wellness -z "$(npx -y delx-wellness-hermes operator --prompt-only)" ``` --- ## 🎬 Demo `setup` wires the 11 default connectors out of the box. The 4 opt-in providers (Eight Sleep, Wellness Air, Cycle Coach, CGM) are off by default — pass `--connectors` to wire all 15 catalogued presets in one command. Real captured output (paths shortened to `~`): ```console $ npx -y delx-wellness-hermes setup \ --connectors whoop,garmin,oura,strava,fitbit,google_health,withings,apple_health,samsung_health,polar,eight_sleep,nourish,wellness_air,wellness_cycle_coach,wellness_cgm Delx Wellness for Hermes setup Profile: delx-wellness Path: ~/.hermes/profiles/delx-wellness Installed: - ~/.hermes/profiles/delx-wellness/config.yaml - ~/.hermes/profiles/delx-wellness/wellness-profile.json - ~/.hermes/profiles/delx-wellness/skills/delx-wellness - ~/.hermes/profiles/delx-wellness/SOUL.md - ~/.hermes/profiles/delx-wellness/AGENTS.md - ~/.hermes/profiles/delx-wellness/ONBOARDING.md Checks: - ok profile_home: Hermes profile home exists at ~/.hermes/profiles/delx-wellness - ok soul: SOUL.md is installed - ok onboarding: ONBOARDING.md is installed - ok wellness_profile: wellness-profile.json is installed - ok config: config.yaml is readable - ok skills_external_dir: Delx Wellness skills directory is registered - ok mcp_connectors: Configured custom MCP connectors: whoop, garmin, oura, strava, fitbit, google_health, withings, apple_health, samsung_health, polar, eight_sleep, nourish, wellness_air, wellness_cycle_coach, wellness_cgm Onboarding: - 4 required questions - 11 total context prompts Next steps: - Install Hermes from https://github.com/NousResearch/hermes-agent. - Then run: npx -y delx-wellness-hermes doctor --profile delx-wellness --run-hermes - Start Hermes with: hermes -p delx-wellness ``` > With Hermes already installed, `setup` also runs the profile/connector checks and prints the model + chat verification commands instead. That run writes **15 MCP server entries** into `~/.hermes/profiles/delx-wellness/config.yaml`, each as a local `npx -y ` command — nothing hosted, no token in the config: ```yaml mcp_servers: whoop: command: npx args: [-y, whoop-mcp-unofficial] garmin: command: npx args: [-y, garmin-mcp-unofficial] # … oura, strava, fitbit, google_health, withings, apple_health, # samsung_health, polar, eight_sleep, wellness_air, # wellness_cycle_coach, wellness_cgm … nourish: command: npx args: [-y, wellness-nourish] ``` Preview any selection without writing via `--dry-run`. Prefer a minimal install? `--connector-mode lite` wires just Garmin + Nourish. Sanitized **expected dry-run shape** (pins + connector catalog, no secrets): [`docs/setup-transcript.md`](docs/setup-transcript.md). --- ## 🎯 Why use it - **🚀 One profile, not ten configs.** Stop wiring connectors by hand — one command sets up the whole stack in a Hermes profile. - **🧭 Daily operator included.** Run one command for a recovery, nutrition and missing-setup plan that starts with available local data. - **💬 Built for daily use.** Real on Hermes terminal, Telegram and other MCP clients — not a one-off demo. - **🥗 Works immediately.** Nourish (local nutrition) is wired without OAuth, so you can chat about food the moment setup finishes. - **15 connector presets ready.** WHOOP, Garmin, Oura, Strava, Fitbit, Google Health, Withings, Apple Health, Samsung Health, Polar, Eight Sleep, Nourish, Air, Cycle Coach and CGM presets included. - **🧠 Onboarding-aware.** The agent gets your goals, schedule, equipment, dietary restrictions and conservative-decision rules **before** it gives advice. - **🔒 Local-first credentials.** Each provider's tokens live inside its own connector's local setup — nothing routed through a hosted vault. --- ## 🏗️ How it fits together ```mermaid flowchart LR User[👤 You] H[Hermes CLI
or Telegram bridge] subgraph Profile[" delx-wellness profile (~/.hermes/profiles/delx-wellness) "] direction TB SOUL[SOUL.md
Recovery-aware operating model] AGENTS[AGENTS.md] ONB[ONBOARDING.md] SK[Skills:
onboarding · daily-brief
training · sleep · nutrition] end subgraph MCP[" Local MCP presets "] direction TB W[whoop-mcp] O[oura-mcp] G[garmin-mcp] S[strava-mcp] F[fitbit-mcp] GH[google-health-mcp] Wi[withings-mcp] AH[apple-health-mcp] SH[samsung-health-mcp] P[polar-mcp] N[nourish 🟢] end User --> H H --> Profile Profile --> MCP MCP --> Providers[(Provider APIs
or local files)] style Profile fill:#0F172A,stroke:#10B981,color:#fff style MCP fill:#0F172A,stroke:#0EA5A3,color:#fff style H fill:#0F172A,stroke:#7C3AED,color:#fff ```

One profile · 15 presets, 11 wired by default · zero hosted vault. Nourish works immediately; OAuth providers are one auth command away, and export connectors need a local file path.

--- ## 🔧 What `setup` does `setup` is the guided path. It: - creates or updates `~/.hermes/profiles/delx-wellness` - installs `SOUL.md`, `AGENTS.md` and `ONBOARDING.md` - installs `DAILY_OPERATOR.md` with the copyable daily operator prompt - installs Delx Wellness skills for **onboarding · daily brief · daily operator · training · sleep · nutrition · setup** - writes local MCP presets for WHOOP, Garmin, Oura, Strava, Fitbit, Google Health, Withings, Apple Health, Samsung Health, Polar and Nourish - runs Hermes profile checks when `hermes` is available - smoke-tests `nourish` through Hermes (it does not require OAuth) - prints the next commands for model setup, chat verification and connector auth Preview before writing: ```bash npx -y delx-wellness-hermes setup --dry-run ``` Preview the operator prompt: ```bash npx -y delx-wellness-hermes operator npx -y delx-wellness-hermes operator --prompt-only ``` Copy `DAILY_OPERATOR.md` into the active profile without running setup again: ```bash npx -y delx-wellness-hermes operator --write ``` ### Personal Recado cron assets For a personal Hermes cron that sends one daily Telegram note from WHOOP + Nourish, use the versioned templates: - `templates/recado_context.py` reads the local WHOOP digest plus recent Nourish `intake.jsonl` entries and prints a read-only context block. - `templates/recado_prompt.txt` keeps the Telegram answer short, causal and explicit about missing food data. Useful runtime overrides: ```bash RECADO_USER_NAME=David \ RECADO_NOURISH_PROFILE=david \ RECADO_LOCAL_TZ=America/Fortaleza \ RECADO_FOOD_LOOKBACK_DAYS=2 \ python3 ~/.hermes/scripts/recado_context.py ``` Skip the Nourish smoke test: ```bash npx -y delx-wellness-hermes setup --skip-smoke ``` --- ## 🛠️ Manual flow Use the manual commands when you want to inspect each step: ```bash npx -y delx-wellness-hermes install --profile delx-wellness --dry-run npx -y delx-wellness-hermes install --profile delx-wellness --write npx -y delx-wellness-hermes onboarding --profile delx-wellness --write npx -y delx-wellness-hermes doctor --profile delx-wellness --run-hermes ``` --- ## ✅ Validate MCP and chat MCP-only checks verify profile files, skills and connector presets: ```bash npx -y delx-wellness-hermes doctor --profile delx-wellness --run-hermes hermes -p delx-wellness mcp list hermes -p delx-wellness mcp test nourish ``` Full chat readiness requires a model/provider configured for the profile: ```bash hermes -p delx-wellness model npx -y delx-wellness-hermes doctor --profile delx-wellness --run-hermes --test-chat ``` > `--test-chat` makes a short Hermes model call, so it may use provider quota. MCP-only checks do not require model access. --- ## 📋 Onboarding worksheet The onboarding worksheet gives the agent the context a real wellness product should ask for — **before** it recommends training, sleep, recovery or nutrition decisions: | Category | What gets captured | |---|---| | **Locale** | Language · timezone · units | | **Body** | Optional age · height · weight · gender context | | **Goals** | Primary goal · secondary goals | | **Devices** | Connected wearables and apps | | **Training** | Schedule · sports · upcoming events · equipment · workout duration | | **Nutrition** | Habits · restrictions · macro goals | | **Health** | Injuries · pain · medical constraints · conservative decision rules | | **Style** | Response format for Telegram or terminal use | The user **never** needs to paste tokens or secrets into chat. --- ## 🔌 Connector presets Default local MCP presets installed by `setup`: | Provider | Package | OAuth needed at setup | |---|---|:---:| | **WHOOP** | [`whoop-mcp-unofficial`](https://www.npmjs.com/package/whoop-mcp-unofficial) | ✅ | | **Garmin** | [`garmin-mcp-unofficial`](https://www.npmjs.com/package/garmin-mcp-unofficial) | ✅ | | **Oura** | [`oura-mcp-unofficial`](https://www.npmjs.com/package/oura-mcp-unofficial) | ✅ | | **Strava** | [`strava-mcp-unofficial`](https://www.npmjs.com/package/strava-mcp-unofficial) | ✅ | | **Fitbit** | [`fitbit-mcp-unofficial`](https://www.npmjs.com/package/fitbit-mcp-unofficial) | ✅ | | **Google Health** | [`google-health-mcp-unofficial`](https://www.npmjs.com/package/google-health-mcp-unofficial) | ✅ | | **Withings** | [`withings-mcp-unofficial`](https://www.npmjs.com/package/withings-mcp-unofficial) | ✅ | | **Apple Health** | [`apple-health-mcp-unofficial`](https://www.npmjs.com/package/apple-health-mcp-unofficial) | ⛔ (uses local export.zip) | | **Samsung Health** | [`samsung-health-mcp-unofficial`](https://www.npmjs.com/package/samsung-health-mcp-unofficial) | ⛔ (uses local CSV/ZIP export) | | **Polar** | [`polar-mcp-unofficial`](https://www.npmjs.com/package/polar-mcp-unofficial) | ✅ | | **Eight Sleep** | [`eight-sleep-mcp-unofficial`](https://www.npmjs.com/package/eight-sleep-mcp-unofficial) | ✅ | | **Nourish** 🟢 | [`wellness-nourish`](https://www.npmjs.com/package/wellness-nourish) | ⛔ (works immediately) | | **Wellness Air** | [`wellness-air`](https://www.npmjs.com/package/wellness-air) | ✅ | | **Cycle Coach** | [`wellness-cycle-coach`](https://www.npmjs.com/package/wellness-cycle-coach) | ⛔ (profile-only context) | | **CGM** | [`wellness-cgm-mcp`](https://www.npmjs.com/package/wellness-cgm-mcp) | ✅ | Exercise Catalog is kept disabled by default because private catalog access may depend on non-public data. --- ## 🌐 Hosted Hub mode Hosted hub mode is explicit and has no default production URL: ```bash npx -y delx-wellness-hermes setup \ --mode hosted \ --hub-url https://your-private-hub.example/mcp \ --dry-run ``` --- ## 🛡️ Public-safe boundary This package is **safe to publish** because it contains: - ✅ profile templates - ✅ public skills - ✅ connector package presets - ✅ config generation - ✅ setup and doctor checks It must **not** contain: - ❌ real user tokens - ❌ OAuth credentials - ❌ personal `~/.hermes` config - ❌ Telegram gateway secrets - ❌ private hosted hub API keys - ❌ private Exercise Catalog data --- ## 🧪 Development ```bash npm install npm test npm pack --dry-run ``` --- ## 🔗 See also - 🏠 **Connector registry** — [`delx-wellness`](https://github.com/davidmosiah/delx-wellness): the public map of all 15 wellness MCP connectors. - 🧰 **Run it in your agent** — [install matrix and client configs](https://github.com/davidmosiah/delx-wellness#run-it-in-your-agent): runnable prompts, MCP configs and profile templates for this stack. - 🌐 **Site** — [wellness.delx.ai/hermes](https://wellness.delx.ai/hermes): live demo, FAQ, and copy-paste configs. - **OpenClaw sibling pack** — [`delx-wellness-openclaw`](https://github.com/davidmosiah/delx-wellness-openclaw): same wellness stack, OpenClaw-native `openclaw.json`, workspace and skills setup. - 🤖 **Hermes** — [`NousResearch/hermes-agent`](https://github.com/NousResearch/hermes-agent): the agent runtime this profile pack targets. --- ## 👤 Built by [David Batista](https://github.com/davidmosiah) — founder of [Delx](https://delx.ai), building protocol layers for autonomous AI agents. Follow on X: [@delx369](https://x.com/delx369) --- ## 📧 Contact & Support - 📨 **support@delx.ai** — general questions, integration help, partnerships - 🐛 **Bug reports / feature requests** — [GitHub Issues](https://github.com/davidmosiah/delx-wellness-hermes/issues) - 🐦 **Updates** — [@delx369](https://x.com/delx369) on X - 🌐 **Site** — [wellness.delx.ai](https://wellness.delx.ai) ## 📜 License MIT — see [LICENSE](LICENSE). Community: [Code of Conduct](CODE_OF_CONDUCT.md). Hermes is a project of NousResearch. WHOOP, Oura, Garmin, Strava, Fitbit, Google Health, Withings, Apple Health, Samsung Health and Polar are trademarks of their respective owners. This profile pack is not affiliated with, endorsed by, or supported by any of them.