Install from source - Morpheus Lumerin Node

This guide builds the proxy-router from source and walks through the API-only consumer flow (no MorpheusUI). For an Electron-included experience, see the packaged installs. For a four-terminal source walk-through (llama.cpp + proxy-router + UI + CLI), see macOS install.

Pre-requisites

An ERC-20 wallet on BASE with MOR + ETH (use a top-level, not derived, address). Never share your private key.

TL;DR

Install and configure proxy-router

Once.

Authorize the contract

Once per wallet (or whenever the allowance is depleted).

Query the blockchain for a model

Per session.

Open a session

Per session.

Send prompts

Per session.

A. Build & run the proxy-router

Install OS dependencies

git (https://git-scm.com), go 1.22+ (https://golang.org).

Clone and enter 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

Set at minimum:

WALLET_PRIVATE_KEY= — your wallet’s private key.
ETH_NODE_ADDRESS=wss://... — recommended: an Alchemy/Infura BASE WSS endpoint. Reference: Env: proxy-router.

Build and start

./build.sh
./proxy-router

On future updates: git pull && ./build.sh && ./proxy-router. Confirm Swagger at http://localhost:8082/swagger/index.html.

B. Authorize the contract

Either via Swagger or curl. Once per wallet, or when allowance is depleted.

curl -X POST \
  'http://localhost:8082/blockchain/approve?spender=0x6aBE1d282f72B474E54527D93b979A4f64d3030a&amount=3' \
  -H 'accept: application/json' -d ''

C. Query for a model

curl -X GET 'http://localhost:8082/wallet' -H 'accept: application/json'
curl -X GET 'http://localhost:8082/blockchain/models' -H 'accept: application/json'

Pick an Id from the response and use it as <modelId> below. See the API endpoints reference for the full schema.

D. Open a session

curl -s -X POST \
  'http://localhost:8082/blockchain/models/<modelId>/session' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"sessionDuration": 600}'

The transaction will appear in your wallet’s history at https://base.blockscout.com/address/<wallet_id>.

E. Prompt

curl -X POST 'http://localhost:8082/v1/chat/completions' \
  -H 'accept: application/json' \
  -H 'session_id: <sessionId>' \
  -H 'Content-Type: application/json' \
  -d '{
    "messages": [{"role":"user","content":"tell me a joke"}],
    "stream": true
  }'

The response is OpenAI-compatible SSE.

Quick-and-dirty one-liner

# Approve, query wallet, list models, open a session, prompt
curl -X POST 'http://localhost:8082/blockchain/approve?spender=0x6aBE1d282f72B474E54527D93b979A4f64d3030a&amount=3' -H 'accept: application/json' -d ''
curl -s 'http://localhost:8082/wallet' | jq .address
curl -s 'http://localhost:8082/blockchain/models' | jq -r '.models[] | "\(.Id), \(.Name)"'
SESSION=$(curl -s -X POST 'http://localhost:8082/blockchain/models/<modelId>/session' \
  -H 'Content-Type: application/json' -d '{"sessionDuration":600}' | jq -r .sessionId)
curl -X POST 'http://localhost:8082/v1/chat/completions' \
  -H "session_id: $SESSION" -H 'Content-Type: application/json' \
  -d '{"messages":[{"role":"user","content":"tell me a joke"}],"stream":true}'

Docker (consumer)Open a session (buy a bid)

​Pre-requisites

​TL;DR

​A. Build & run the proxy-router

​B. Authorize the contract

​C. Query for a model

​D. Open a session

​E. Prompt

​Quick-and-dirty one-liner

Pre-requisites

TL;DR

A. Build & run the proxy-router

B. Authorize the contract

C. Query for a model

D. Open a session

E. Prompt

Quick-and-dirty one-liner