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

ToolMinimum
gitlatesthttps://git-scm.com
go1.22+https://golang.org
node20+https://nodejs.org
makeanyhttps://www.gnu.org/software/make
yarnanyhttps://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.
1

Clone & build

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

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
3

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
4

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)
1

Clone the repo

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

Configure .env

cp .env.example .env
vi .env
See Env: proxy-router for every field.
3

Build & run

./build.sh
make run
Allow firewall prompts on first launch.
4

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.