macOS install (from source, 4-terminal walk-through)

A simple guide to get the local llama.cpp model, the Lumerin proxy-router, and the MorpheusUI from source running on a Mac.

For a packaged install (no compilation), use the Consumer quickstart. This page is for developers or contributors.

Wallet: if you start with an existing MetaMask wallet, use a tier-1 (top-level) address, not a derived/secondary one. MorpheusUI’s mnemonic-recover flow does not work properly with secondary addresses derived under the same mnemonic.

Dependencies

Tool	Minimum
`git`	latest	https://git-scm.com
`go`	1.22+	https://golang.org
`node`	20+	https://nodejs.org
`make`	any	https://www.gnu.org/software/make
`yarn`	any	https://yarnpkg.com

Step A — llama.cpp (terminal 1)

You will need a port for the local model server (8080 in this guide). This setup is one-time.

Clone & build

git clone https://github.com/ggerganov/llama.cpp.git
cd llama.cpp
make -j 8

Pick a model

Set general variables:

model_host=127.0.0.1
model_port=8080

Then pick a model (full set in docs/mac-boot-strap.md):

model_url=https://huggingface.co/TheBloke
model_collection=TinyLlama-1.1B-Chat-v1.0-GGUF
model_file_name=tinyllama-1.1b-chat-v1.0.Q4_K_M.gguf

Download and run

wget -O models/${model_file_name} \
  ${model_url}/${model_collection}/resolve/main/${model_file_name}
./llama-server -m models/${model_file_name} \
  --host ${model_host} --port ${model_port} --n-gpu-layers 4096

Validate

Open http://127.0.0.1:8080 and confirm the local llama.cpp UI responds.

Step B — proxy-router (terminal 2)

You’ll need:

Wallet private key (do not share, used in .env)
ETH node WSS or HTTPS URL (Alchemy/Infura) for BASE
Ports for the proxy (3333) and API (8082)

Clone the repo

git clone https://github.com/MorpheusAIs/Morpheus-Lumerin-Node.git
cd Morpheus-Lumerin-Node/proxy-router

Configure .env

cp .env.example .env
vi .env

See Env: proxy-router for every field.

Build & run

./build.sh
make run

Allow firewall prompts on first launch.

Validate

Confirm log lines like:

INFO  proxy state: running
INFO  HTTP  http server is listening: 0.0.0.0:8082
INFO  TCP   tcp server is listening: 0.0.0.0:3333

Open http://localhost:8082/swagger/index.html.

Step C — MorpheusUI (terminal 3)

cd <your_path>/Morpheus-Lumerin-Node/MorpheusUI
cp .env.example .env
vi .env  # confirm PROXY_WEB_URL points at the proxy-router API port
yarn install
yarn dev

The Electron app launches into onboarding. Confirm:

Lower-left shows your ERC-20 wallet.
Wallet tab shows MOR + ETH balances.
Chat tab is set to Provider: (local) by default.

Step D — CLI (terminal 4)

cd <your_path>/Morpheus-Lumerin-Node/cli
cp .env.example .env
vi .env  # confirm API_HOST is http://localhost:8082
make build
./mor-cli -h
./mor-cli healthcheck

Cleaning and troubleshooting

Save your wallet mnemonic before any cleanup.
rm -rf ./node_modules from inside MorpheusUI if dependencies get stuck.
rm -rf ~/Library/Application\ Support/MorpheusUI to start with a fresh wallet store.
Dangling processes: ps -ax | grep electron / ps -ax | grep proxy-router then kill -9 <pid>.
Locked log files in ./data/: lsof | grep /proxy-router/data/ and kill the holding process.

For more, see Troubleshooting.

Consumer quickstart Windows install

​Dependencies

​Step A — llama.cpp (terminal 1)

​Step B — proxy-router (terminal 2)

​Step C — MorpheusUI (terminal 3)

​Step D — CLI (terminal 4)

​Cleaning and troubleshooting

Dependencies

Step A — llama.cpp (terminal 1)

Step B — proxy-router (terminal 2)

Step C — MorpheusUI (terminal 3)

Step D — CLI (terminal 4)

Cleaning and troubleshooting