# Hermes Voice Gateway: Hermes Agent plugin

> Answers Twilio phone calls with Hermes: caller speech is transcribed and Hermes' replies are spoken with ElevenLabs over a Pipecat pipeline.

Canonical: https://hermeswatcher.com/plugins/hermes-voice-gateway  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/hermes-voice-gateway  
Last updated in catalog: 2026-11-17

Answers Twilio phone calls with Hermes: caller speech is transcribed and Hermes' replies are spoken with ElevenLabs over a Pipecat pipeline. Callers get only two restricted tools (inventory search, enquiry save). Operator-approved callbacks are proposed by the agent and dialed only after a human runs /voice-callback approve.

## Good to know before installing

Runs a call server on 127.0.0.1:8081 (VOICE_WEBHOOK_HOST / VOICE_WEBHOOK_PORT) that a tunnel or reverse proxy must expose to Twilio; Twilio webhooks are signature-checked and callers must be on VOICE_ALLOWED_USERS, but caller ID can be spoofed, so treat the allowlist as a filter, not authentication. Install it in a dedicated voice profile: callers talk to a normal Hermes agent that can see that profile's persona, project context and voice instructions, and calls are refused unless that profile's memory and user profile are off and no memory provider is set. Call audio goes to ElevenLabs (speech-to-text and text-to-speech) and call metadata and callbacks go to the Twilio REST API; the optional local dev pipeline also uses OpenAI. Caller enquiries are stored as plaintext in the plugin's own SQLite file under HERMES_HOME.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs (this one needs `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`, `ELEVENLABS_API_KEY`, `VOICE_WEBHOOK_URL`), then asks whether to turn it on.

```bash
hermes plugins install hermes-voice-gateway
```

2. Said no? Turn it on later:

```bash
hermes plugins enable hermes-voice-gateway
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Chat apps & voice, Web, research & browsing
- Maintained by: SRai22 (Community)
- Needs: `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`, `ELEVENLABS_API_KEY`, `VOICE_WEBHOOK_URL` (API keys)
- Adds tools: `voice_propose_callback`, `voice_check_call_status`, `voice_start_local_pipeline`, `voice_search_inventory`, `voice_save_enquiry`
- Requires Hermes: `>=0.23.2`
- Version: 0.2.0
- In the catalog since: 2026-11-17

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/hermes-voice-gateway)
- [Source code](https://github.com/SRai22/hermes-voice-gateway/blob/71f5801cad5f00f68cdd6c1f5df8ad11922cb870/README.md)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
