# Qmd Workspaces: Hermes Agent plugin

> Convert uploaded document folders to Markdown, index them in QMD, and retrieve relevant passages for Hermes Desktop with Ollama.

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

Convert uploaded document folders to Markdown, index them in QMD, and retrieve relevant passages for Hermes Desktop with Ollama.

## Good to know before installing

Reads documents you upload into Hermes' workspaces folder and sends your prompt text and extracted document passages to the configured Ollama endpoint (loopback by default, optionally reached through the Tailscale CLI); writes the shared QMD index and collection config in your user cache and config directories (`~/.cache/qmd`, `~/.config/qmd`), loads QMD's sqlite-vec native extension, and may run `qmd status` and `pdftotext`.

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 qmd-workspaces
```

2. Said no? Turn it on later:

```bash
hermes plugins enable qmd-workspaces
```

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: Hermes Desktop add-ons
- Maintained by: lad75020 (Community)
- Needs: No API keys declared
- Adds tools: `qmd_workspace_search`, `qmd_workspace_index`, `qmd_workspace_list`
- Works on: macos, linux
- Requires Hermes: `>=0.23.0`
- Version: 1.0.2
- In the catalog since: 2026-11-15

## Links

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