This is the simplest way to get started with the Morpheus Lumerin Node as a consumer. It runs three pieces of software on your local machine:
  • proxy-router — same binary as the provider side, configured for the consumer role.
  • MorpheusUI — Electron GUI to browse bids, open sessions, and chat.
  • (Optional) llama.cpp — bundled sample model for free local-only testing. Started by passing local to mor-launch.

​
Installation

1

Download the release

Grab the latest archive for your OS from the GitHub releases page.
  • Mainnet builds have no suffix (e.g. v7.0.0).
  • Testnet builds end in -test (e.g. v7.0.0-test).
2

Extract

cd ~/Downloads/morpheus
xattr -c mor-launch mor-cli proxy-router MorpheusUI.app
3

(Optional) tweak the .env

Inspect the bundled .env and edit only if you need advanced behavior (custom log destination, private ETH node, alternate ports). Reference: Env: proxy-router.
4

Launch

./mor-launch
# Or, to also start the bundled local model:
./mor-launch local
A terminal window will show the proxy-router (and local model if requested) starting; MorpheusUI will launch on top.
5

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.
  • Optional CLI: in another terminal, ./mor-cli (Linux/macOS).

​
Validation

1

Confirm proxy-router is up

Open http://localhost:8082/swagger/index.html — the Swagger UI should render. Logs in ./data/ capture detail. See Troubleshooting.
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.
  • Closing the MorpheusUI window leaves the launcher CMD open. Use Ctrl-C there to stop the local model and proxy-router.

​
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.
rm .cookie proxy.conf
rm -rf ~/Library/Logs/morpheus-ui
rm -rf ~/Library/Application\ Support/morpheus-ui
rm -rf data
xattr -c proxy-router MorpheusUI.app mor-launch mor-cli
Linux: also check ~/.config/morpheus-ui.

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