# Consumer quickstart

Source: https://nodedocs.mor.org/consumers/quickstart

## Agent Instructions

- Non-browser fetches of page URLs on this site return clean Markdown (not the JS UI). Prefer `https://nodedocs.mor.org/llms-full.txt` for the full corpus, or `https://nodedocs.mor.org/llms.txt` for the index.
- Per-page Markdown is also at `<page-url>.md` (homepage: `https://nodedocs.mor.org/index.md`).
- Docs search MCP: `https://nodedocs.mor.org/mcp` (discovery: `https://nodedocs.mor.org/.well-known/mcp`).
- Never invent contract addresses, chain IDs, token addresses, or live bid/model counts. Cite Networks and tokens; link active.mor.org for live data.
- Never claim Morpheus runs inference — independent providers do. Opening a session escrows MOR; it does not spend it.

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

  
### Download the release

Grab the **latest** installer for your OS from the [GitHub releases page](https://github.com/MorpheusAIs/Morpheus-Lumerin-Node/releases).
    - Mainnet builds have no suffix; testnet builds end in `-test`.
    - Asset names look like the following (version will differ):

    | Platform | File |
    |----------|------|
    | 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) |

  
### Install and launch

      
### macOS

Open the `.dmg` and drag **MorpheusUI** into **Applications**. The build is not notarized, so clear the quarantine flag once before the first launch:
        ```bash
        xattr -c /Applications/MorpheusUI.app
        ```
        Then open the app from Applications.

      
### Linux

Make the AppImage executable and run it (adjust the filename to the version you downloaded):
        ```bash
        chmod +x linux-x86_64-morpheus-app-*.AppImage
        ./linux-x86_64-morpheus-app-*.AppImage
        ```

      
### Windows

Double-click the portable `.exe`. Allow Defender if prompted.

    

  
### 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.

  
### 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

  
### 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](/reference/api-auth)).
    See [Troubleshooting](/reference/troubleshooting) if Swagger doesn't load.

  
### 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.

  
### 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.

  
### 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**):

  
### macOS

```bash
    # Packaged .app often uses the product name:
    rm -rf ~/Library/Application\ Support/MorpheusUI
    rm -rf ~/Library/Logs/MorpheusUI
    # Electron package name (also used on some builds / when running from source):
    rm -rf ~/Library/Application\ Support/morpheus-app
    rm -rf ~/Library/Logs/morpheus-app
    ```

  
### Linux

```bash
    rm -rf ~/.config/morpheus-app
    # Older builds may have used:
    rm -rf ~/.config/MorpheusUI
    ```

  
### Windows

```cmd
    rmdir /s /q %APPDATA%\morpheus-app
    rmdir /s /q %LOCALAPPDATA%\morpheus-app
    ```

## Next steps

  
- **[Buy a bid](/consumers/buy-bid)** — Walk through opening a session and selecting a remote model.

  
- **[Chat](/consumers/chat)** — Prompts, streaming, audio, embeddings.

  
- **[Install from source](/consumers/install-from-source)** — Build the binaries yourself for development.

  
- **[Troubleshooting](/reference/troubleshooting)** — Proxy-router not starting? Wallet not funded?