# Butler: Hermes Agent plugin

> Turns Hermes into a proactive personal assistant.

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

Turns Hermes into a proactive personal assistant. You set your daily non-negotiables and Butler checks in until they are done or deferred; you tell it about a commitment and it follows up before it slips, with the model choosing whether and when to follow up inside owner-set limits (max unanswered nudges, minimum gap between messages). If you opt in, it can also ring your phone for urgent follow-ups or place calls you approve, through your own LiveKit SIP trunk. You choose its tone (Gentle to Strict), how persistent it is, quiet hours, time zone and a daily cap on check-ins, and can pause it in one click. A concierge-style Hermes Desktop page shows today's non-negotiables, upcoming commitments, recent activity and preferences, with a 4-step Quick Setup; the same controls are available to the agent as tools in chat.

## Good to know before installing

A background runner thread in the gateway process schedules check-ins, which run as normal turns in your admitted DM or local chat on your configured model, billed like any message; with background wakes enabled it sets allow_gateway_injection for this plugin; with system controls on it writes notification, display and nudge settings into your Hermes config.yaml (keys listed in the README, including agent.gateway_notify_interval, skills.creation_nudge_interval, gateway.message_timestamps.enabled, platforms.*.gateway_restart_notification and the top-level timezone once confirmed), replacing existing per-platform values for those keys; the agent can change Butler's own settings through butler_controls when asked, while DM capture, notification arming and every phone setting stay user-only; the optional prompt review writes to SOUL.md and a butler-capabilities skill only after you select and apply each change, keeping backups; the optional 'verify time zone via IP' action calls ipapi.co or worldtimeapi.org only when you ask; phone calling is off by default; once you enable it in Desktop and add your LiveKit credentials (read through Hermes secret_scope), Butler sends HTTPS requests to your LIVEKIT_URL to ring you within hourly/cooldown/quiet-hours limits, or to place third-party calls only after you approve the exact script (Desktop or CLI, never the agent; emergency and premium numbers blocked; calls open with an AI disclosure); if you also enable inbound screening, an AI answers inbound calls on your trunk and takes messages; an optional, user-started voice worker (pip extra 'voice') connects to LiveKit and OpenAI for live call audio and may run a local `hermes chat` subprocess to answer your questions on a call; call transcripts and summaries, including what the other party said, are stored locally and shown to your agent after the call; iMessage voice and image helpers run local ffmpeg/ffprobe and hand files to Hermes as MEDIA: reply attachments (Butler never reads Hermes runtime secrets or calls the Photon sidecar); watches read the local file path you ask it to watch; inbound DM event capture is off by default and needs two separate opt-ins; all state is stored in plaintext SQLite in the profile's plugin-data; no telemetry.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs (this one needs `LIVEKIT_URL`, `LIVEKIT_API_KEY`, `LIVEKIT_API_SECRET`, `LIVEKIT_SIP_TRUNK_ID`, `LIVEKIT_CALLER_NUMBER`, `OPENAI_API_KEY`), then asks whether to turn it on.

```bash
hermes plugins install butler-assistant
```

2. Said no? Turn it on later:

```bash
hermes plugins enable butler-assistant
```

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: Automation & multi-agent, Chat apps & voice
- Maintained by: haykguy (Community)
- Needs: `LIVEKIT_URL`, `LIVEKIT_API_KEY`, `LIVEKIT_API_SECRET`, `LIVEKIT_SIP_TRUNK_ID`, `LIVEKIT_CALLER_NUMBER`, `OPENAI_API_KEY` (API keys)
- Adds tools: `butler_create`, `butler_manage`, `butler_expression`, `butler_imessage`, `butler_phone`, `butler_controls`
- Requires Hermes: `>=0.23.1`
- Version: 0.5.0
- In the catalog since: 2026-11-14

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/butler-assistant)
- [Source code](https://github.com/haykguy/butler#readme)
- [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
