When BlenderGPT is not working, the cause is almost always one of five things: a Blender version below 4.2, a failed add-on install, a broken account link, an exhausted credit allowance, or a blocked network connection. Work through them in that order — the checks take under 5 minutes total and each one has a definitive test.
The add-on refuses to install
Symptom: Blender rejects the zip or the entry never appears in the add-on list. Cause: the add-on manifest requires Blender 4.2.0 as a minimum, and older versions cannot load the extension format. Fix: check your version in the Blender splash screen; anything below 4.2 needs an update before the add-on will install. Also make sure you selected the zip itself — do not unzip it first.
Installed, but the app cannot see your scene
Symptom: the add-on is enabled, yet the web app says nothing is connected. Three fixes, in order:
- Confirm you approved the network permission — it is the add-on’s only permission, and declining it silently kills the sync.
- Sign out and back in inside the add-on panel, so the account link refreshes.
- Check whether a firewall or VPN is blocking the connection; the bridge needs an open path to the BlenderGPT service.
A clean re-test afterwards: ask the app to import any free asset. If it appears in the viewport, sync is healthy again.
Generations queue forever or fail
Symptom: prompts sit in a queued state or come back with an error. First check your credit balance — each paid plan includes a monthly credit allowance shared between assistant use and generation, and a drained balance looks a lot like a malfunction. Second, retry with a simpler, single-object prompt; very long multi-object requests take disproportionately longer. Third, give it one honest retry a few minutes later before assuming your setup broke: cloud queues have busy moments.
Results land, but look wrong in your scene
Symptom: the model arrives tiny, huge, or floating. This is usually scene units rather than the generation itself — a scene set to centimeters will make a normally sized chair look monumental. Reset your unit scale or apply a quick resize; the mesh itself is standard Blender geometry and takes any transform.
When it is genuinely on their end
If every check above passes and things still fail, contact the product team through the support email on the official site — include your Blender version and the add-on version (currently v2.2.0). Account and billing problems can only be fixed there. For a from-scratch reinstall afterwards, the download guide has the full four-step sequence, and the getting-started tutorial rebuilds the setup from zero.