# Carbon Voice + Hermes

> **About this integration**
>
>[Why Carbon Voice?](../concepts/why-carbonvoice.md)
>
>- **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

1. [Create an agent](../api-how-to/how-to-create-a-voice-agent-account.md)
2. Generate a Personal Access Token (PAT) for that agent
3. Copy the PAT - you'll need it for configuration

## 2 - Connect your agent

### Install dependencies

```bash
python -m pip install 'python-socketio[asyncio_client]>=5'
```

### Install the Carbon Voice Plugin

```bash
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

```bash
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](https://carbonvoice.app/download)

## 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