# Disko: Hermes Agent plugin

> Run and steer a disko AI DJ set on your Mac from any Hermes chat. disko's model picks each next track and beat-matches the mix; this plugin launches it on a music folder or a Spotify playlist, starts the set,…

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

Run and steer a disko AI DJ set on your Mac from any Hermes chat. disko's model picks each next track and beat-matches the mix; this plugin launches it on a music folder or a Spotify playlist, starts the set, steers the energy, asks for a different next track, pauses and stops, through ten tools, a /disko slash command and a hermes disko CLI that need no model turn, and a pre_llm_call hook that tells the agent what is playing while a set runs. Standard library only.

## Good to know before installing

Talks only to disko's local control socket (~/.disko/control.sock), which disko restricts to the same macOS user, so no token is used; reads ~/.disko/install.json (disko's folder and Python path, written by disko; not a credential) to find disko, and reads no token or credential file. No third-party network calls (an optional control_url, set by the user, is contacted over plain HTTP with a token from Hermes's secret store). disko_launch starts disko as a background process with a fixed command (no shell) and a minimal environment (none of Hermes's API keys) that keeps running after Hermes exits and logs to the plugin's data folder (a Spotify playlist is passed only as `liked` or a playlist id; disko, not the plugin, then uses the user's own Spotify sign-in, and only if the user turned Spotify audio on in disko themselves); disko_start plays music out loud on the Mac. While a set runs, one line of track names is added to each message and reaches the model provider. Requires disko (github.com/emirkaan5/disko) on macOS. 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 disko
```

2. Said no? Turn it on later:

```bash
hermes plugins enable disko
```

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: emirkaan5 (Community)
- Needs: No API keys declared
- Adds tools: `disko_status`, `disko_find_tracks`, `disko_start`, `disko_set_energy`, `disko_pick_again`, `disko_pause`, `disko_resume`, `disko_stop`, `disko_launch`, `disko_quit`
- Works on: macos
- Requires Hermes: `>=0.21.5`
- Version: 0.4.2
- In the catalog since: 2026-11-14

## Links

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