Delx Wellness for Hermes

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.}

If Hermes is already installed:

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), 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 -z "$(npx -y delx-wellness-hermes operator --prompt-only)"

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 ~):

$ 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 <connector-package> command — nothing hosted, no token in the config:

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.

• 🚀 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.

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

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.

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:

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

Preview the operator prompt:

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:

npx -y delx-wellness-hermes operator --write

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:

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:

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

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

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.

The onboarding worksheet gives the agent the context a real wellness product should ask for — before it recommends training, sleep, recovery or nutrition decisions:

The user never needs to paste tokens or secrets into chat.

Default local MCP presets installed by setup:

Exercise Catalog is kept disabled by default because private catalog access may depend on non-public data.

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

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

The existing CI runs on Ubuntu with Node.js 22. Profile-path validation includes real Linux installer/uninstaller entrypoint regressions using isolated temporary profiles, including traversal and symlink rejection with unchanged protected test data.

Native Windows/macOS filesystem behavior (including case, normalization and path aliases) has not been validated by this regression harness. Windows-specific lexical checks are not a substitute for native OS tests. These checks are not a sandbox and do not establish protection against concurrent same-user filesystem changes (TOCTOU). Explicit custom paths and operator-configured HOME or .hermes relocation remain trusted operator configuration; no universal platform-safety guarantee is claimed.

npm install
npm test
npm pack --dry-run

• 🏠 Connector registry — delx-wellness: the public map of all 15 wellness MCP connectors.
• 🧰 Run it in your agent — install matrix and client configs: runnable prompts, MCP configs and profile templates for this stack.
• 🌐 Site — wellness.delx.ai/hermes: live demo, FAQ, and copy-paste configs.
• OpenClaw sibling pack — delx-wellness-openclaw: same wellness stack, OpenClaw-native openclaw.json, workspace and skills setup.
• 🤖 Hermes — NousResearch/hermes-agent: the agent runtime this profile pack targets.

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

Follow on X: @delx369

• 📨 support@delx.ai — general questions, integration help, partnerships
• 🐛 Bug reports / feature requests — GitHub Issues
• 🐦 Updates — @delx369 on X
• 🌐 Site — wellness.delx.ai

MIT — see LICENSE. Community: Code of Conduct.

_{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.}