hermes-voice-assistant

Configure a Hermes Agent voice assistant with Groq LLM, Whisper STT, and Edge TTS.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-voice-assistant-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-voice-assistant
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/voice/hermes-voice-assistant
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-voice-assistant-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building a voice assistant on top of Hermes Agent requires wiring together a fast LLM endpoint, speech-to-text, text-to-speech, and wake-word detection, and Hermes v0.20.x rejects common configuration patterns like a first-class groq provider string. This Skill provides the validated configuration schema, auth commands, and latency tuning needed to get a sub-2-second speech-to-sound assistant running without hitting the documented pitfalls. ## Core Features & Use Cases - Custom Groq endpoint wiring: Registers a custom:groq-ev provider via custom_providers in config.yaml, routing queries through the full Hermes agent loop (persona, memory, tools) rather than a bare LLM call. - Local voice stack: Uses faster-whisper tiny for STT, Edge TTS with a pinned voice, and the sherpa open-vocabulary wake-word engine requiring zero training. - Latency tuning: Documents a full latency budget (target under 2s) with voice-mode keys like silence_duration, barge_in, and streaming TTS that overlaps LLM generation. - Use Case: You want a talking companion AI on your machine that remembers context and uses tools. Follow the setup steps to create a Hermes profile, register the Groq API key, install voice dependencies, and say the wake phrase to get spoken replies. ## Quick Start Ask the agent to set up a Hermes voice assistant profile using a custom Groq endpoint with wake word, local Whisper STT, and Edge TTS following this skill's config schema.

Frequently Asked Questions about hermes-voice-assistant

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a voice assistant with Hermes Agent?▼

Create a Hermes profile, write a config.yaml with a custom Groq provider, register the API key with hermes auth add, install the voice and wake extras via uv pip install, then run hermes voice. Queries route through the full agent loop with persona, memory, and tools.

Why does Hermes reject provider groq in config.yaml?▼

Hermes v0.20.x has no first-class groq provider string, so provider: groq returns an unknown provider error. Use provider: custom:groq-ev with a custom_providers entry specifying base_url https://api.groq.com/openai/v1 and api_mode openai.

What Groq models work for low-latency voice assistants?▼

openai/gpt-oss-20b runs at roughly 1000 tokens per second with near-zero time to first token, making it the fastest free option. qwen/qwen3.6-27b and openai/gpt-oss-120b run at 500 tok/s. Deprecated IDs like llama-3.1-8b-instant return HTTP 404.

Why does hermes auth add fail with EOFError?▼

Without the --label flag, hermes auth add calls input() interactively, which fails with EOFError under non-interactive or piped shells. Always pass --label, for example hermes -p name auth add custom:groq-ev --type api-key --label groq-ev.

How do I reduce voice assistant response latency?▼

Lower voice.silence_duration to 1.5 and silence_threshold to 150, enable barge_in, disable beep_enabled, and keep auto_tts on. Streaming TTS speaks the first sentence while the LLM generates the rest, targeting roughly 1.0 to 1.5 seconds speech-to-sound.

Does the wake word require training a custom model?▼

No. The sherpa wake-word engine is open vocabulary, so any phrase works with zero training. Set wake_word.provider to sherpa and type the phrase directly, such as phrase: hey E V, with adjustable sensitivity.