⚡ Quick Start

If Hermes is already installed:

npx -y delx-wellness-hermes setup
hermes -p delx-wellness

That's it. The installer creates ~/.hermes/profiles/delx-wellness, installs the wellness skills, writes the MCP presets for all 11 connectors, 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:

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:

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

🎯 Why use it

• 🚀 One profile, not ten configs. Stop wiring connectors by hand — one command sets up the whole stack in a Hermes profile.
• 💬 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.
• ⌚ Ten wearable/API/export sources ready. WHOOP, Garmin, Oura, Strava, Fitbit, Google Health, Withings, Apple Health, Samsung Health and Polar 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

flowchart LR
    User[👤 You]
    H[Hermes CLI<br/>or Telegram bridge]

    subgraph Profile[" delx-wellness profile (~/.hermes/profiles/delx-wellness) "]
      direction TB
      SOUL[SOUL.md<br/>Recovery-aware operating model]
      AGENTS[AGENTS.md]
      ONB[ONBOARDING.md]
      SK[Skills:<br/>onboarding · daily-brief<br/>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<br/>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

🔧 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 Delx Wellness skills for onboarding · daily brief · 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:

npx -y delx-wellness-hermes setup --dry-run

Skip the Nourish smoke test:

npx -y delx-wellness-hermes setup --skip-smoke

🛠️ Manual flow

Use the manual commands when you want to inspect each step:

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:

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:

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 | ✅ | | Garmin | garmin-mcp-unofficial | ✅ | | Oura | oura-mcp-unofficial | ✅ | | Strava | strava-mcp-unofficial | ✅ | | Fitbit | fitbit-mcp-unofficial | ✅ | | Google Health | google-health-mcp-unofficial | ✅ | | Withings | withings-mcp-unofficial | ✅ | | Apple Health | apple-health-mcp-unofficial | ⛔ (uses local export.zip) | | Samsung Health | samsung-health-mcp-unofficial | ⛔ (uses local CSV/ZIP export) | | Polar | polar-mcp-unofficial | ✅ | | Nourish 🟢 | wellness-nourish | ⛔ (works immediately) |

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:

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

npm install
npm test
npm pack --dry-run

🔗 See also

• 🏠 Connector registry — delx-wellness: the public map of all 11 wellness MCP connectors.
• 🌐 Site — wellness.delx.ai/hermes: live demo, FAQ, and copy-paste configs.
• 🤖 Hermes — NousResearch/hermes-agent: the agent runtime this profile pack targets.

👤 Built by

David Batista — founder of Delx, building protocol layers for autonomous AI agents.

Follow on X: @delx369

📜 License

MIT — see LICENSE.

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.