# Local Hands: Hermes Agent plugin

> Remote brain, local hands: Hermes runs on your server while terminal, read_file, write_file, patch, search_files and execute_code run on your own computers, through a one-file, stdlib-only daemon that dials out…

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

Remote brain, local hands: Hermes runs on your server while terminal, read_file, write_file, patch, search_files and execute_code run on your own computers, through a one-file, stdlib-only daemon that dials out to the Hermes host over key-pinned TLS and asks you before acting (per conversation, per command, or never). Pair several machines and let the agent switch between them and the host with the hands tool; each keeps its own working directory. Answers #18715 and #1855 on the public terminal-backend surface.

## Good to know before installing

Starts a long-running detached hub process on the Hermes host that listens on all network interfaces on a TCP port (default 0.0.0.0:7717, self-signed TLS, so clients use ssl.CERT_NONE plus a SHA-256 public-key pin) once the hands backend runs its first command or you run `hermes hands up` / `pair`, and serves the daemon source hands.py over HTTPS on that port (no self-update); runs shell commands sent by the Hermes host on each paired machine under the user's account (not a sandbox); with the 'brain' target on (the default) the agent can also switch its terminal to the Hermes host itself, through Hermes' local backend; command output returns to Hermes and so to the model provider; writes TLS key and certificate, devices.json (token hashes only), audit.jsonl and hub.log under plugin-data/local-hands/, and ~/.config/local-hands/ on each machine; adds one short context line to a turn when the active machine changes; Hermes dangerous-command approvals stay on; no telemetry, no third-party service, no credentials read from files.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install local-hands
```

2. Said no? Turn it on later:

```bash
hermes plugins enable local-hands
```

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: Web, research & browsing, Automation & multi-agent
- Maintained by: noegng (Community)
- Needs: No API keys declared
- Adds tools: `hands`
- Works on: linux, macos
- Requires Hermes: `>=0.22.5`
- Version: 1.1.0
- In the catalog since: 2026-11-15

## Links

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