discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
MorpheusAIs/Morpheus-Lumerin-Node · source
Snapshot 0 · 2026-11-04T12:47:27Z · Go · MIT
Content fingerprint
f62ac3634215efc3d7119b137b3d1b7d769686551232512bb9079cf41908eb52GitHub description at capture
Enable interaction with distributed, decentralized LLMs on the Morpheus network through a desktop chat experience
README at capture
# Morpheus Lumerin Node  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 1** — *consumer → 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](https://nodedocs.mor.org/providers/full/tee-reference), the [SecretVM quickstart](https://nodedocs.mor.org/providers/full/secretvm-quickstart), and the [TEE backend verification developer reference](https://nodedocs.mor.org/providers/full/tee-backend-verification). ## Documentation The canonical documentation lives at **[nodedocs.mor.org](https://nodedocs.mor.org)**. Source files are in [`/docs`](docs/) and built with [Mintlify](https://mintlify.com). 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`](docs/docs.json). The site is structured around **role-based journeys** (consumer / prosumer / provider tiers), with anti-hallucination [AI knowledge](https://nodedocs.mor.org/ai/myths) pages and curated mirrors of the broader [ecosystem](https://nodedocs.mor.org/ecosystem/overview) ([mor.org](https://mor.org), [tech.mor.org](https://tech.mor.org) including the [ALL / ACTIVE / GATEWAY explainer](https://tech.mor.org/active.html), [active.mor.org](https://active.mor.org), [MyProvider](https://myprovider.mor.org), [Everclaw](https://everclaw.xyz), [NodeNeo](https://nodeneo.io), [app.mor.org](https://app.mor.org)). ## What's in this repo - Lumerin `proxy-router` — background process that monitors blockchain contract events, manages secure sessions between consumers and providers, and routes prompts and responses between them. - `ui-desktop/` (**MorpheusUI**) — Electron desktop app for consumers. Release assets are `*-morpheus-app-*` installers (`.dmg` / `.AppImage` / portable `.exe`); on first launch the app downloads the proxy-router, a local `llama.cpp` + tinyllama demo model, and an IPFS (kubo) node. There is no zip / `mor-launch` package in current releases. - `cli/` — CLI client (`*-morpheus-cli-*` release binaries; local builds produce `mor-cli`). - Standalone `*-morpheus-router-*` release binaries for headless / provider deployments. ## End-to-end picture 0. **PreRequisites**: BASE Layer 2 Blockchain, MOR and ETH on BASE for staking and bidding. 1. Existing, Hosted AI model available for inference via the Morpheus network. 2. The proxy-router talks to and listens to the blockchain; it routes prompts and inference between providers' models and consumers. 3. Providers register their models via bids on the blockchain. 4. The consumer node is the "client" that purchases bids, sends prompts via the proxy-router, and receives inference back from the provider's models. 5. Consumers stake MOR to open a session for the duration they intend to use. 6. 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` | `0xA328196f2438DADA5ab729E39388D86896c27c85` | | 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](https://nodedocs.mor.org/get-started/quickstart-consumer) | | Provider (host your own model) | [Provider quickstart](https://nodedocs.mor.org/get-started/quickstart-provider) | | Provider on Railway (same GHCR image) | [Railway docs](https://nodedocs.mor.org/providers/full/proxy-router-railway) · [video](https://youtu.be/-z-EPK11qmM) | | TEE provider (SecretVM) | [SecretVM quickstart](https://nodedocs.mor.org/providers/full/secretvm-quickstart) | | Resale provider | [Resale overview](https://nodedocs.mor.org/providers/resale/overview) | | Prosumer / agent | [Prosumer overview](https://nodedocs.mor.org/prosumers/overview) | | Developer (API) | [API overview](https://nodedocs.mor.org/reference/api-overview) | ## Contributing **PRs should target [`dev`](https://github.com/MorpheusAIs/Morpheus-Lumerin-Node/tree/dev), not `main`.** Changes promote `dev` → `test` → `main`. See [`CONTRIBUTING.md`](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`](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`](https://nodedocs.mor.org/llms-full.txt) | Complete markdown export — primary ingestion path | | Page index | [`llms.txt`](https://nodedocs.mor.org/llms.txt) | Titles, descriptions, and per-page `.md` links | | Page Markdown | append `.md` or non-browser fetch | Same page URL returns clean Markdown when `Accept` lacks `text/html` | | Docs MCP | [`/mcp`](https://nodedocs.mor.org/mcp) | Search / retrieve pages without scraping HTML | See `AGENTS.md` for priority reading slugs and anti-hallucination rules.