# Visor: Hermes Agent plugin

> Live holographic canvas for AI agents: the visor_push tool pushes visual blocks — sections, markdown findings, clickable todos, tables, KPI stats, charts, code, images, audio and video — to an infinite-canvas…

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

Live holographic canvas for AI agents: the visor_push tool pushes visual blocks — sections, markdown findings, clickable todos, tables, KPI stats, charts, code, images, audio and video — to an infinite-canvas webpage that updates in place over SSE (the page is never rewritten), so agents SHOW work instead of dumping it in chat. Turnkey: the plugin ships its own server, no separate install.

## Good to know before installing

On first use, if nothing is listening on localhost:8900, the plugin auto-starts its bundled server as a long-running background process (bare-python subprocess by default, state in ~/.local/share/visor or VISOR_DATA; `docker compose up -d` when VISOR_DOCKER=1), restarted if unreachable, and the child gets only a minimal environment (PATH/HOME/LANG/TZ, VISOR_* values, plus DOCKER_* and proxy vars for compose); it listens on 127.0.0.1:8900 by default, and VISOR_HOST opts in to a non-loopback bind that is refused unless VISOR_TOKEN is set; /api/* and /media/ are always gated by a per-install token (0600, <state>/visor-token), which the page receives automatically only on a loopback bind (otherwise open the page with ?token=...); the page refuses framing and foreign Host headers; the bundled live module polls user-pushed http(s) URLs every 2s (10s timeout, 1MB cap, no redirects) and refuses loopback, private, link-local and metadata addresses unless they are listed in VISOR_LIVE_LOCAL_HOSTS; the chat module forwards card sends to a configured Hermes webhook (VISOR_CHAT_URL + VISOR_CHAT_SECRET) and does nothing until those are set; raw-html cards render in a sandboxed iframe whose postMessage bridge can only read board state and edit blocks on the current board; visor_push copies local image/audio/video files the model names (no dotfile paths) into its media dir; no credentials beyond its own VISOR_* settings, no telemetry.

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

2. Said no? Turn it on later:

```bash
hermes plugins enable visor
```

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: Chat apps & voice, Images, video, music & 3D
- Maintained by: samundra0 (Community)
- Needs: No API keys declared
- Adds tools: `visor_push`
- Requires Hermes: `>=0.21.5`
- Version: 1.9.0
- In the catalog since: 2026-11-15

## Links

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