Barehand

From its catalog listing

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 its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install barehand
  2. Said no? Turn it on later:
    hermes plugins enable barehand
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
AI models & providers · Automation & multi-agent
Maintained by
mrv777 (Community)
Needs
No API keys declared
Adds tools
barehand_machine
Adds hooks
pre_tool_call
Works on
linux, macos
Needs Hermes
0.23.0 or newer
Version
0.1.0
In the catalog
2026-11-14

Known issues (from its catalog listing)

  • With `plugins.isolation: host`, Hermes skips register_cli_command, so the `hermes barehand ...` commands are unavailable. The default mode (`in_process`) registers them. The plugin was not run in host mode, so whether the barehand_machine tool and the computer_use provider load there is unverified. Use the default.
  • Only QEMU guests on an Apple Silicon Mac were run. The Linux KVM and Intel Mac paths are covered by unit tests only.
  • The VNC transport (transport: vnc) was tested only against QEMU's own VNC server. No KVM-over-IP hardware, BMC, PiKVM or other hypervisor was tested. VNC is not encrypted and has no snapshot, reset, eject or power control.
  • One model per machine, because QEMU serves one QMP client. Typing is US-layout ASCII. Windows hosts are unsupported.
  • Screen text was measured under QEMU on Alpine 3.24, Debian 13.7 and Ubuntu Server 26.04.1. Their GRUB menus are text consoles and read without calibration. Fedora and other distros are untested.
  • Calibration is per console font: run calibrate_text at a shell on the same console as the screens to read.
  • Debian-installer dialogs and graphical installers return no text. Screens dominated by non-ASCII are partly readable, with unreadable cells marked by a replacement character. Box drawing reads as a shade glyph on the Linux console. aarch64 UEFI shell text reading is unverified.
  • A slowly changing screen (period near 0.8 s) can be reported as a confirmed change.
  • You supply QEMU, UEFI firmware (edk2/OVMF) and the ISO; Barehand installs and downloads nothing. The model must receive tool-result images.
  • Every key, type and click is a Hermes approval prompt; grant a session scope for long runs. Unattended (cron or gateway) use needs approvals granted beforehand.
  • QEMU receives an environment allowlist (PATH, HOME, TMPDIR, LANG, LC_* and similar), never Hermes' environment. The guest has QEMU user-mode networking. QMP is unauthenticated: a unix socket in a 0700 directory by default, loopback TCP as a fallback, non-loopback only with allow_remote. The optional VNC transport is unencrypted (weak DES password, keystrokes in clear), contacts only the configured host, and needs allow_remote for a non-loopback host.
  • The flight recorder is on by default: screenshots and key chords under the plugin data dir (mode 0600). Typed text is off by default (length only). `record: false` disables the recorder and `hermes barehand recordings purge --yes` deletes recordings.
  • One pre_tool_call hook only escalates reset, power_off, eject_media, send_ctrl_alt_del, snapshot_load, snapshot_delete and a snapshot_save that overwrites an existing snapshot to Hermes' approval prompt. status, snapshot_list, snapshot_save under a new name, calibrate_text (types the 94 printable ASCII characters at a Linux prompt) and wait_for_text do not ask.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in ai models & providers

All ai models & providers plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins