Skip to content

MorpheusAIs/Morpheus-Lumerin-Node

Repository files navigation

Morpheus Lumerin Node

Simple-Overview

The purpose of this software is to enable interaction with distributed, decentralized LLMs on the Morpheus network through a desktop chat experience.

v7.0.0 — Full TEE capability. The v7 release completes a two-hop Trusted Execution Environment (TEE) trust chain for any model registered on-chain with the tee tag:

  • Phase 1consumer → P-Node. A consumer proxy-router (v6.0.0+) cryptographically verifies the provider's P-Node runs the exact official hardened -tee image inside a genuine Intel TDX SecretVM, with TLS pinning, at session open and on every prompt.
  • Phase 2 (new in v7)P-Node → backend LLM. The v7+ P-Node itself verifies the backend LLM it forwards inference to (CPU TDX quote, TLS pinning, workload RTMR3 replay of the backend's docker-compose.yaml, CPU-GPU nonce binding, and NVIDIA NRAS GPU attestation) at startup and on every prompt.

Because Phase 2 runs inside the attested P-Node, any v6+ consumer is forward-compatible with a v7+ provider and gains the Phase 2 guarantees automatically — no client-side upgrade required. See the TEE reference, the SecretVM quickstart, and the developer reference at proxy-router/docs/tee-backend-verification.md.

Documentation

The canonical documentation lives at nodedocs.mor.org. Source files are in /docs and built with Mintlify. The site replaces the previous 00-overview.md / 02-*.md / 04-*.md / 99-troubleshooting.md set of files; old paths still resolve via redirects in docs/docs.json.

The site is structured around role-based journeys (consumer / prosumer / provider tiers), with anti-hallucination AI knowledge pages and curated mirrors of the broader ecosystem (mor.org, tech.mor.org, active.mor.org, MyProvider, Everclaw, NodeNeo, app.mor.org).

What's in this repo

  • Local Llama.cpp and tinyllama model to run locally for demonstration purposes only.
  • Lumerin proxy-router — background process that monitors blockchain contract events, manages secure sessions between consumers and providers, and routes prompts and responses between them.
  • Lumerin MorpheusUI — the Electron front end UI to interact with LLMs and the Morpheus network as a consumer.
  • Lumerin cli — CLI client to interact with LLMs and the Morpheus network as a consumer.
  • Kubo ipfs — IPFS client to store and retrieve model/agent files.

End-to-end picture

  1. PreRequisites: BASE Layer 2 Blockchain, MOR and ETH on BASE for staking and bidding.
  2. Existing, Hosted AI model available for inference via the Morpheus network.
  3. The proxy-router talks to and listens to the blockchain; it routes prompts and inference between providers' models and consumers.
  4. Providers register their models via bids on the blockchain.
  5. The consumer node is the "client" that purchases bids, sends prompts via the proxy-router, and receives inference back from the provider's models.
  6. Consumers stake MOR to open a session for the duration they intend to use.
  7. Once the session is open, prompt and inference (ChatGPT-like) can start.

Tokens and contract information

Item BASE Mainnet BASE Sepolia (testnet)
Chain ID 8453 84532
Branch main (MAIN-* releases) test (*-test releases)
MOR Token 0x7431aDa8a591C955a994a21710752EF9b882b8e3 0x5C80Ddd187054E1E4aBBfFCD750498e81d34FfA3
Diamond Marketplace 0x6aBE1d282f72B474E54527D93b979A4f64d3030a 0x6e4d0B775E3C3b02683A6F277Ac80240C4aFF930
Block Explorer https://base.blockscout.com/ https://base-sepolia.blockscout.com/

You will need both MOR (for stake / fees / session payment) and ETH on BASE (for gas) in your wallet.

Quickstart

Role Start here
Consumer (chat) Consumer quickstart
Provider (host your own model) Provider quickstart
TEE provider (SecretVM) SecretVM quickstart
Resale provider Resale overview
Prosumer / agent Prosumer overview
Developer (API) API overview

Contributing

PRs should target dev, not main. Changes promote devtestmain.

See CONTRIBUTING.md for the branch model, PR checklist, and local docs/proxy-router tips. The GitHub PR template reminds you to pick the right base branch.

For AI agents reading this repo

Start with AGENTS.md — hard rules, quick lookup tables, and ingestion instructions.

To load the full documentation corpus in one fetch:

Resource URL Use
Full corpus (preferred) llms-full.txt Complete markdown export — fetch this, do not scrape HTML pages
Page index llms.txt Titles, descriptions, and slugs for every page

Individual nodedocs page URLs are for human browsing and citation only. See AGENTS.md for priority reading slugs and anti-hallucination rules.

About

Enable interaction with distributed, decentralized LLMs on the Morpheus network through a desktop chat experience

Topics

Resources

License

Contributing

Stars

19 stars

Watchers

2 watching

Forks

Packages

 
 
 

Contributors