Install from source

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.
Basic Auth credentials for the local API. On first start the proxy-router writes admin:<password> to .cookie next to the binary — use those credentials in Swagger (Authorize) and in every curl below. See API auth.

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. Click Authorize and enter the admin / password from .cookie before using Try it out — almost every route requires Basic Auth (same as the curl headers below).

B. Authorize the contract

Either via Swagger or curl. Once per wallet, or when allowance is depleted. In Swagger: Authorize → run POST /blockchain/approve. Via curl (replace the Basic value with base64(username:password) from your .cookie, or use -u 'admin:<password>'):

curl -X POST \
  'http://localhost:8082/blockchain/approve?spender=0x6aBE1d282f72B474E54527D93b979A4f64d3030a&amount=3' \
  -H 'Authorization: Basic <base64(user:pass)>' \
  -H 'accept: application/json' -d ''

C. Query for a model

curl -X GET 'http://localhost:8082/wallet' \
  -H 'Authorization: Basic <base64(user:pass)>' \
  -H 'accept: application/json'

curl -X GET 'http://localhost:8082/blockchain/models' \
  -H 'Authorization: Basic <base64(user:pass)>' \
  -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 'Authorization: Basic <base64(user:pass)>' \
  -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 'Authorization: Basic <base64(user:pass)>' \
  -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
# AUTH from .cookie — either header form or: curl -u 'admin:<password>' ...
AUTH='Authorization: Basic <base64(user:pass)>'
SPENDER=0x6aBE1d282f72B474E54527D93b979A4f64d3030a

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

Get started

Inference API (hosted)

Concepts

Consumers

Prosumers

Providers - Resale

Providers - Full P-Node

AI knowledge

Ecosystem

Reference

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

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