The consumer release is a single desktop app per OS. On first launch, the app downloads and manages the services it needs:
  • proxy-router — same binary as the provider side, configured for the consumer role.
  • llama.cpp AI runtime + the tinyllama demo model — for free local-only testing, started automatically.
  • An IPFS node (kubo) — used for agent/model file distribution.

​
Installation

1

Download the release

Grab the latest installer for your OS from the GitHub releases page.
  • Mainnet builds have no suffix; testnet builds end in -test.
  • Asset names look like the following (version will differ):
2

Install and launch

Open the .dmg and drag MorpheusUI into Applications. The build is not notarized, so clear the quarantine flag once before the first launch:
Then open the app from Applications.
3

Let the app fetch and start its services

The first launch (and the first one after each update) shows a Starting services screen with two sections:
  • Downloading — the app fetches the proxy-router first (required), then best-effort downloads for the llama.cpp AI runtime, the tinyllama demo model, and an IPFS node, skipping anything already present on disk.
  • Startup — Proxy Router starts first (required for onboarding and marketplace use). IPFS, AI Runtime, and Container Runtime are optional and started afterward; a failure there does not block the UI.
Container Runtime (Docker) is only detected, never installed — it is needed solely for containerized agent features. Local AI Runtime is only for the free tinyllama demo; remote Morpheus models do not need it. Skip continues into the app; Retry re-runs any failed step.
4

Onboard MorpheusUI

  • Read & accept the terms.
  • Set a strong password (this protects MorpheusUI’s local key store; it is not your wallet password).
  • Either create a new wallet (write down the mnemonic) or recover an existing top-level wallet via mnemonic.

​
Validation

1

Confirm proxy-router is up

Open http://localhost:8082/swagger/index.html — the Swagger UI should render. If you use Try it out on API routes, click Authorize and enter the admin credentials from the proxy-router .cookie file (see API auth). See Troubleshooting if Swagger doesn’t load.
2

Local-model test (optional)

In MorpheusUI’s Chat tab, ensure Local Model is selected. Type a prompt and press Enter. A response confirms the local model + proxy-router pipeline works.
3

Remote-model test

Click Change Model, select a remote provider model, click Change, then Open Session. Stake at least 5 MOR (contract minimum). Chat away.
4

Close out

  • Manually close all remote sessions: in the Chat window, click the time icon next to the model line, then the X next to each open session.
  • Quitting MorpheusUI also stops the managed services (proxy-router, AI runtime, IPFS).

​
Cleanup

If you need to reset to a fresh state (different release, broken state):
Save your wallet mnemonic / private key first. Cleanup deletes the local key store.
The app keeps everything — downloaded services, proxy-router data, and the wallet store — in Electron’s userData directory. The package name is morpheus-app (that is the folder name on disk; the product name shown in the UI is MorpheusUI):

​
Next steps

Buy a bid

Walk through opening a session and selecting a remote model.

Chat

Prompts, streaming, audio, embeddings.

Install from source

Build the binaries yourself for development.

Troubleshooting

Proxy-router not starting? Wallet not funded?