# Consumer quickstart

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

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

<Steps>
  <Step title="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) |
  </Step>
  <Step title="Install and launch">
    <Tabs>
      <Tab title="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.
      </Tab>
      <Tab title="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
        ```
      </Tab>
      <Tab title="Windows">
        Double-click the portable `.exe`. Allow Defender if prompted.
      </Tab>
    </Tabs>
  </Step>
  <Step title="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.
  </Step>
  <Step title="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.
  </Step>
</Steps>

## Validation

<Steps>
  <Step title="Confirm proxy-router is up">
    Open `http://localhost:8082/swagger/index.html` — the Swagger UI should render.
    See [Troubleshooting](/reference/troubleshooting) if it doesn't.
  </Step>
  <Step title="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.
  </Step>
  <Step title="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.
  </Step>
  <Step title="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).
  </Step>
</Steps>

## Cleanup

If you need to reset to a fresh state (different release, broken state):

<Warning>
**Save your wallet mnemonic / private key first.** Cleanup deletes the local key store.
</Warning>

The app keeps everything — downloaded services, proxy-router data, and the wallet store — in its per-user application data directory:

<Tabs>
  <Tab title="macOS">
    ```bash
    rm -rf ~/Library/Application\ Support/MorpheusUI
    rm -rf ~/Library/Logs/MorpheusUI
    ```
  </Tab>
  <Tab title="Linux">
    ```bash
    rm -rf ~/.config/MorpheusUI
    ```
  </Tab>
  <Tab title="Windows">
    ```cmd
    rmdir /s /q %APPDATA%\MorpheusUI
    ```
  </Tab>
</Tabs>

## Next steps

<CardGroup cols={2}>
  <Card title="Buy a bid" icon="cart-shopping" href="/consumers/buy-bid">
    Walk through opening a session and selecting a remote model.
  </Card>
  <Card title="Chat" icon="comments" href="/consumers/chat">
    Prompts, streaming, audio, embeddings.
  </Card>
  <Card title="Install from source" icon="github" href="/consumers/install-from-source">
    Build the binaries yourself for development.
  </Card>
  <Card title="Troubleshooting" icon="circle-question" href="/reference/troubleshooting">
    Proxy-router not starting? Wallet not funded?
  </Card>
</CardGroup>