Start at Settings → Clusters → Setup. Connections says what Clusters can reach, in plain words.

"This plugin needs Model Hub. Install and enable it from Community plugins."

Why: Model Hub is missing or turned off. Fix: install and enable Model Hub, then add a provider in its settings.

"This plugin needs Model Hub API …; the installed Hub offers …"

Why: Model Hub is older than Clusters needs. Fix: update Model Hub. With BRAT, run its update command.

"Not installed, so book collections are unavailable. Notes and Bases work without it."

Why: Books & Shelves isn't installed. Fix: nothing, unless you want collections of books. Then install Books & Shelves.

"Server off. Start the Content Server in Calibre (Connect/share → Start Content server) to index books."

Why: Books come through Calibre's Content Server, and it isn't running. Fix: start it in Calibre, then select the check button under Connections.

"Content Server on, read-only: books with only an AZW3 or MOBI can't be converted…"

Why: Calibre's server answers but doesn't allow changes, and converting a book adds an EPUB to it. An index runs, but leaves those books out and names them in its report. Fix: in Calibre, Preferences → Sharing over the net → Advanced → Allow un-authenticated local connections to make changes, Apply, then stop and start the server. The row under Connections says the same, and Books & Shelves' guide has the full table of settings Calibre needs.

"No collection notes in …"

Why: the collections folder has no collection note. Fix: make one with New collection… on the Collections tab. See Make a collection.

A collection note is refused, naming a property

Why: the note's properties can't be read: reader or source is missing or misspelled, or the properties aren't valid YAML. Fix: the message names the property. Compare the note with the example in Make a collection.

A job "has made no progress for five minutes"

Why: a model call is slow or stuck. Fix: wait, or cancel it from Clusters: Open jobs. A later run picks up where it stopped.

A run stopped at a limit

Why: it reached the spend limit you set, or one of Model Hub's: a tier's per-call limit or monthly budget. Fix: raise the limit and run it again. What was already read is kept. For Model Hub's limits, see its Tiers tab.

A draft wrote nothing

Why: the model's reply was cut off at the length limit, or wasn't a draft Clusters could read. Fix: the message says which, and where the reply is kept. Try again with fewer seeds, or move clusters.write to a tier with a model that allows longer replies.

"No Clusters run to undo."

Why: there are no runs, or the run is older than the last five of its kind. Fix: none. Older runs can't be undone.

Questions

My new lens doesn't show

Reload the skills in Model Hub, then open the Lenses tab. If it shows with a problem, run Check my lenses.

Does it work on mobile?

No. Clusters is desktop only.

Will uninstalling delete my work?

It deletes the indexes, which live in the plugin's folder. Your notes stay. Copy .obsidian/plugins/clusters/corpora out first to keep the indexes.

Still stuck? See Getting help.