# SceneMux: Hermes Agent plugin

> Turn an MP3 into a beat-aligned, lip-synced music video from any Hermes agent.

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

Turn an MP3 into a beat-aligned, lip-synced music video from any Hermes agent. Eight tools: scenemux_doctor (health/keys), scenemux_setup (start the studio server via Docker, provisions keys from the agent secret scope), scenemux_project (upload audio + references, beat-grid analysis, Whisper lyrics), scenemux_plan (LLM storyboard with beat-locked scenes, shown for review before anything is generated), scenemux_render (spend-gated: cost estimate first, confirm=true is escalated to a Hermes human-approval gate), scenemux_status, scenemux_export (final MP4, optional 9:16 vertical cut), scenemux_cancel. The storyboard director can run on a cloud LLM, a local Ollama model, or the agent itself (director_backend=hermes) via the local Hermes API server. A bundled skill (scenemux:studio) carries the operator workflow.

## Good to know before installing

The plugin talks only to the user's own SceneMux studio server (default http://127.0.0.1:8000) and reads the audio/reference paths the agent passes it; scenemux_setup starts one local server process (Docker container, port-published on 127.0.0.1 only) that runs until the session ends; planning and stills call the LLM/image/video backends configured on that server; the default cloud preset spends Comfy Cloud credits on renders, which is why renders are estimate-first and a confirm=true call is escalated to the user's approval gate; the server is reachable on loopback only (compose publishes 127.0.0.1 ports, no wildcard CORS), and tool calls to non-loopback hosts are refused; secrets are read only through the agent secret scope, are sent only to loopback / host.docker.internal hosts, and the server .env is written (chmod 600) only for a 127.0.0.1-bound server; no telemetry. Disclosure — SceneMux talks to your own SceneMux studio server (default http://127.0.0.1:8000), which scenemux_setup can start as a local Docker container published on 127.0.0.1 only; it uploads the audio and reference images the agent passes it, and the studio sends prompts and images to the LLM, image and video backends configured there (the default cloud preset spends Comfy Cloud credits, so renders show a cost estimate first and confirmed renders go through Hermes' approval prompt); API keys are read through the agent secret scope and sent only to a local studio, the Home Agent address comes only from the plugin's home_agent_url setting, and a ComfyUI address the agent passes for local rendering receives your reference images; 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 `COMFY_CLOUD_API_KEY`, `OLLAMA_API_KEY`, `OPENCODE_API_KEY`, `FAL_KEY`, `HOME_AGENT_PASSWORD`, `API_SERVER_KEY`), then asks whether to turn it on.

```bash
hermes plugins install scenemux
```

2. Said no? Turn it on later:

```bash
hermes plugins enable scenemux
```

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: Images, video, music & 3D, Security & privacy
- Maintained by: ep150de (Community)
- Needs: `COMFY_CLOUD_API_KEY`, `OLLAMA_API_KEY`, `OPENCODE_API_KEY`, `FAL_KEY`, `HOME_AGENT_PASSWORD`, `API_SERVER_KEY` (API keys)
- Adds tools: `scenemux_doctor`, `scenemux_setup`, `scenemux_project`, `scenemux_plan`, `scenemux_render`, `scenemux_status`, `scenemux_export`, `scenemux_cancel`
- Requires Hermes: `>=0.23.0`
- Version: 0.5.1
- In the catalog since: 2026-11-17

## Links

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