# Barehand: Hermes Agent plugin

> Lets an agent operate a machine with no OS, network or agent on it (firmware menus, boot loaders, installers, rescue shells such as grub>) through the screen and keyboard alone.

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

Lets an agent operate a machine with no OS, network or agent on it (firmware menus, boot loaders, installers, rescue shells such as grub>) through the screen and keyboard alone. It provides a computer_use provider for QEMU virtual machines over QMP (or a VNC console), a barehand_machine tool, a hermes barehand CLI, a skill and a flight recorder. In recorded runs a model installed Debian 13 from the network installer (it repaired a grub> prompt on first boot from the installer's rescue mode) and Ubuntu Server 26.04 (it finished the stalled installer by hand) on blank aarch64 machines. `hermes barehand demo` replays a bundled recording. Evidence is in the README and docs/results.

## Good to know before installing

`hermes barehand up` starts local qemu-system/qemu-img processes that keep running after Hermes exits until `hermes barehand down`. The guest has QEMU user-mode (NAT) networking and can reach whatever the host can. QMP is unauthenticated on a 0700 unix socket (or a loopback TCP port fallback). The optional VNC transport is unencrypted. The flight recorder is on by default and stores screenshots and key chords (typed text as length only) under the plugin data dir. `barehand_machine` runs status, snapshot_list, snapshot_save under a new name, calibrate_text (types a fixed ASCII test line) and wait_for_text without an approval prompt.

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

2. Said no? Turn it on later:

```bash
hermes plugins enable barehand
```

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: AI models & providers, Automation & multi-agent
- Maintained by: mrv777 (Community)
- Needs: No API keys declared
- Adds tools: `barehand_machine`
- Works on: linux, macos
- Requires Hermes: `>=0.23.0`
- Version: 0.1.0
- In the catalog since: 2026-11-14

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/barehand)
- [Source code](https://github.com/mrv777/barehand/blob/20b74e03a085a67d59f4287d0e61b5fed6bbb217/barehand/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
