1
Download a release
Grab the latest package for your OS from the GitHub releases page. Mainnet builds have no suffix; testnet builds end in
-test. Asset names look like (version will differ):| OS | File |
|---|---|
| macOS | mac-arm64-morpheus-app-<version>.dmg (Apple Silicon) or mac-x64-... (Intel) |
| Linux | linux-x86_64-morpheus-app-<version>.AppImage (or linux-arm64-...) |
| Windows | win-x64-morpheus-app-<version>.exe (portable) |
2
Install and launch
- macOS
- Linux
- Windows
Open the Then open the app from Applications.
.dmg and drag MorpheusUI into Applications. The build is not notarized, so clear the quarantine flag before the first launch:3
Let the app fetch its components
On every OS, the first launch (and the first launch after an update) shows a Starting services screen. The app downloads the components it needs — the proxy-router, the AI runtime (
llama.cpp), the local demo model (tinyllama), and an IPFS node — verifying what is already present and skipping anything it already has. It then starts each service and shows per-item status.One item, Container Runtime (Docker), is only detected, never installed: it is required solely for containerized agent features. If a service fails or you don’t need it — no Docker installed, for example — click Skip to continue into the app; Retry re-runs the failed steps.4
Onboard the UI
In MorpheusUI, accept the terms, set a password, and either create a new wallet or recover an existing one with your mnemonic. Save the mnemonic somewhere safe.
5
Fund the wallet
Send
MOR and ETH on BASE to the wallet address shown in the lower-left of the UI. See Networks and tokens.6
Open a session and chat
Click Chat → Change Model, pick a remote model, click Open Session, stake at least
5 MOR, and prompt away. To close early, expand the session line and click the X next to it.