Skip to content

Add Hermes Connector ability - #366

Open
Bradymck wants to merge 1 commit into
openhome-dev:devfrom
Bradymck:add-hermes-connector
Open

Add Hermes Connector ability#366
Bradymck wants to merge 1 commit into
openhome-dev:devfrom
Bradymck:add-hermes-connector

Conversation

@Bradymck

Copy link
Copy Markdown

Summary

  • Adds community/hermes-connector/ — routes voice/chat requests from an OpenHome ability directly to a self-hosted Hermes agent's OpenAI-compatible API server (POST /v1/chat/completions), then speaks the response back.
  • No local bridge process needed at runtime — just two ability secrets (hermes_api_url, hermes_api_key).
  • README is written in plain, simple English with numbered setup steps, aimed at non-native English speakers.

Test plan

  • Deployed and tested live end-to-end against a real OpenHome DevKit + a self-hosted Hermes instance (exposed via Tailscale Funnel) — confirmed voice trigger → Hermes response → spoken back.
  • Validated with openhome validate locally before submitting.
  • get_api_keys() return value defensively normalized (handles both string and dict shapes seen in testing).

Sends voice/chat requests from an OpenHome ability directly to a
self-hosted Hermes agent's OpenAI-compatible API server (POST
/v1/chat/completions), and speaks the response back. No local bridge
process required at runtime.

README written in plain, simple English (ESL-friendly) with numbered
setup steps.
@Bradymck
Bradymck requested a review from a team as a code owner August 21, 2026 19:46
@github-actions

Copy link
Copy Markdown
Contributor

🔀 Branch Merge Check

PR direction: add-hermes-connectordev

Passedadd-hermes-connectordev is a valid merge direction

@github-actions

Copy link
Copy Markdown
Contributor

✅ Community PR Path Check — Passed

All changed files are inside the community/ folder. Looks good!

@github-actions github-actions Bot added the community-ability Community-contributed ability label Aug 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🔍 Lint Results

🔧 Formatting fixes available

This PR is from a fork, so fixes could not be pushed automatically. Download the python-lint-results artifact from the workflow run for the patch file, then run:

git apply autofix.patch

__init__.py — Empty as expected

Files linted: community/hermes-connector/main.py

✅ Flake8 — Passed

✅ All checks passed!

@github-actions

Copy link
Copy Markdown
Contributor

✅ Ability Validation Passed

📋 Validating: community/hermes-connector
  ✅ All checks passed!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-ability Community-contributed ability

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant