Carbon Voice + Hermes
About this integration
- Talk to Hermes agents — Record voice messages to trigger Hermes agents instantly while on-the-go with the mobile app
- Send even when agent is offline and recovers — Your messages are queued and delivered when you next open your Hermes session.
1 - Create an Agent Account and Get PAT
- Create an agent
- Generate a Personal Access Token (PAT) for that agent
- Copy the PAT - you'll need it for configuration
2 - Connect your agent
Install dependencies
python -m pip install 'python-socketio[asyncio_client]>=5'
Install the Carbon Voice Plugin
hermes plugins install PhononX/hermes-plugin-carbonvoice --enable
Configure the Plugin
When prompted, paste your Carbon Voice Personal Access Token (PAT).
Start the Hermes Gateway
hermes gateway run
3 - Talk to your agent
Get desktop app to setup hotkeys to talk to your agent. Get mobile app to talk to your agent on the go. Download Carbon Voice
Troubleshooting
| Problem | Solution |
|---|---|
| Plugin install fails | Make sure you have Hermes installed and have internet connectivity |
| Plugin prompts for PAT again | Verify your PAT is correct and hasn't expired |
| No response from Hermes | Check that the gateway is running with the correct status |
| Gateway won't start | Check Hermes logs for errors, ensure no port conflicts |
| Messages not received | Verify the PAT has the correct permissions for your agent and restart the gateway: hermes gateway restart |
Need help? Reach out in Carbon Voice: Settings → Help → Support
Security Notes
- Your Carbon Voice PAT is stored in Hermes's configuration. Keep your machine secure.
- Never commit your PAT to version control
- If you suspect your PAT has been compromised, revoke it immediately from the developer portal and create a new one
- Hermes runs locally on your machine, giving it access to your files, tools, and workflows. Only install Hermes from trusted sources