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):
PlatformFile
macOS (Apple Silicon)mac-arm64-morpheus-app-<version>.dmg
macOS (Intel)mac-x64-morpheus-app-<version>.dmg
Linux (x64)linux-x86_64-morpheus-app-<version>.AppImage
Linux (ARM64)linux-arm64-morpheus-app-<version>.AppImage
Windows (x64)win-x64-morpheus-app-<version>.exe (portable)
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, the llama.cpp AI runtime, the tinyllama demo model, and an IPFS node, skipping anything already present on disk.
  • Startup — each service is started and probed: IPFS, AI Runtime, Container Runtime, Proxy Router.
Container Runtime (Docker) is only detected, never installed — it is needed solely for containerized agent features. If you don’t have or need Docker (or another service fails), click Skip to continue into the app anyway; 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. See Troubleshooting if it doesn’t.
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 its per-user application data directory:

​
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?