This page focuses on consumer-side symptoms. For provider-side or deeper proxy-router operational issues, see the full Reference: troubleshooting.

​
”Where is my MOR?” / wallet balance dropped

You almost certainly opened a session. The MOR is escrowed in the Diamond contract, not lost. See:

​
MorpheusUI shows zero balance after recovering my wallet

You probably recovered a derived address from your mnemonic. MorpheusUI only resolves the top-level address from a mnemonic. Use a tier-1 wallet, or import the private key directly.

​
”Provider not responding” or stuck mid-prompt

  • Confirm the proxy-router is still running (http://localhost:8082/healthcheck, or check the Proxy Router entry on MorpheusUI’s startup screen).
  • The provider may be down. Close the session early; an immediate partial refund hits your wallet, and any timelocked slice in userStakesOnHold becomes claimable via withdrawUserStakes after ~1 UTC day:
  • Try a different model from a different provider.

​
Local model returns nonsense

The bundled tinyllama is a demonstration model only. It will hallucinate, miscount, and contradict itself. Don’t compare it to a real Morpheus model. See Local vs on-chain models.

​
Swagger / API not reachable on :8082

  • Check the Proxy Router entry on MorpheusUI’s startup screen — expand Show logs for errors, or use Restart.
  • Common cause: invalid ETH node URL or wrong chain/contract addresses. See proxy-router env reference.
  • macOS: ensure xattr -c removed the quarantine flag from the app.

​
xattr / quarantine errors on macOS

The desktop app builds are not notarized. Clear the quarantine flag on the installed app:
If you run a standalone proxy-router binary, clear it there too: xattr -c proxy-router.

​
I want to start over completely

Save the mnemonic first, then follow Cleanup.