# Troubleshooting

> The messages you may see, and how to fix each one.

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](collections.md).

## 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](collections.md).

## 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](https://github.com/Insurgent-Methods/clusters/blob/HEAD/SUPPORT.md).