Skip to content

docs(spotify): document setup and Home Assistant speaker routing#26796

Closed
BROCCOLO1D wants to merge 1 commit into
NousResearch:mainfrom
BROCCOLO1D:docs/15615-spotify-ha-interop
Closed

docs(spotify): document setup and Home Assistant speaker routing#26796
BROCCOLO1D wants to merge 1 commit into
NousResearch:mainfrom
BROCCOLO1D:docs/15615-spotify-ha-interop

Conversation

@BROCCOLO1D

Copy link
Copy Markdown
Contributor

Summary

Closes #15615.

Updates the Spotify feature guide to make the first-run hermes setup / hermes setup tools path discoverable alongside hermes tools, and documents that Home Assistant-managed speakers which support Spotify Connect show up through spotify_devices list without any Hermes-side HA↔Spotify bridge.

Why / root cause

The current setup/tool picker on main already includes the spotify toolset and keeps it opt-in, but the user-facing Spotify guide only pointed users at hermes tools. The guide also did not explain the Home Assistant speaker case called out in the issue.

Changes

  • website/docs/user-guide/features/spotify.md: mentions the first-run setup/tools toggle and that it uses the same provider-aware configuration flow as hermes tools.
  • website/docs/user-guide/features/spotify.md: adds a "Home Assistant-managed speakers" subsection explaining Spotify Connect discovery, targeting by display name, and explicit device_id transfer for scripts.

Tests

  • $HOME/.hermes/hermes-agent/venv/bin/python - <<'PY' ... verified spotify is present in CONFIGURABLE_TOOLSETS and remains in _DEFAULT_OFF_TOOLSETS.
  • Not run: pytest (docs-only change).

Out of scope

@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have labels May 16, 2026
teknium1 added a commit that referenced this pull request May 17, 2026
@teknium1

Copy link
Copy Markdown
Contributor

Merged via PR #27247 — your commit was cherry-picked onto current main as part of a batch salvage of low-risk new-contributor PRs. Authorship preserved (docs(spotify): document Home Assistant speaker routing). Thanks for the contribution — appreciate it.

@teknium1 teknium1 closed this May 17, 2026
gweeteve pushed a commit to gweeteve/hermes-agent that referenced this pull request Jun 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Spotify: discoverability polish — surface integration in 'hermes setup', doc HA interop

4 participants