# Morpheus Lumerin Node

> The canonical Morpheus DeAI knowledge base for humans and AI agents. Curated, role-based docs covering consumers, prosumers, providers, the proxy-router API, TEE attestation, and the broader Morpheus ecosystem.

## Pages

- [Introduction](https://nodedocs.mor.org/get-started/introduction): What the Morpheus Lumerin Node is, how the moving parts fit together, and which path to follow next.
- [Consumer quickstart](https://nodedocs.mor.org/get-started/quickstart-consumer): The 5-minute path from zero to chatting with a remote model: download, fund a wallet, open a session, prompt.
- [Provider quickstart](https://nodedocs.mor.org/get-started/quickstart-provider): The 10-minute path from zero to a registered Morpheus provider with a live bid.
- [Networks and tokens](https://nodedocs.mor.org/get-started/networks-and-tokens): BASE mainnet and BASE Sepolia chain IDs, MOR token addresses, and Diamond marketplace contracts shipped with the current release.
- [Morpheus Inference API (hosted)](https://nodedocs.mor.org/inference-api/overview): Use Morpheus inference via a hosted OpenAI-compatible HTTPS gateway — no node, no wallet, just an API key.
- [What is Morpheus?](https://nodedocs.mor.org/concepts/what-is-morpheus): An opinionated explainer of the Morpheus Inference Marketplace: a decentralized, peer-to-peer marketplace for AI inference, coordinated by smart contracts on BASE.
- [Architecture](https://nodedocs.mor.org/concepts/architecture): How the proxy-router, MorpheusUI, models, and BASE blockchain compose into a working consumer/provider system.
- [Sessions: stake, close, claim](https://nodedocs.mor.org/concepts/sessions-stake-close-recover): The complete lifecycle of a Morpheus session — open, stake, close (natural vs early), and the on-hold timelock for early closes. Why MOR is not 'gone' just because the session is open.
- [Local vs on-chain models](https://nodedocs.mor.org/concepts/local-vs-onchain-models): When you are using the bundled local llama.cpp model versus a real Morpheus blockchain model — and why expectations and pricing differ.
- [TEE: trusted execution overview](https://nodedocs.mor.org/concepts/tee-overview): The two-hop trust chain (consumer → P-Node → backend LLM) introduced in v7.0.0. What it guarantees, what it does not, and how it is enforced.
- [Tokens, fees, and economics](https://nodedocs.mor.org/concepts/tokens-and-fees): MOR vs ETH on BASE, who pays what when, and where the on-chain minimums come from.
- [Rewards and economics](https://nodedocs.mor.org/concepts/rewards-and-economics): Two distinct reward systems in the Morpheus stack: provider session payouts (Compute Node, this repo) and stake-for-liquidity (Capital Contract). They are often conflated; they should not be.
- [Consumer quickstart](https://nodedocs.mor.org/consumers/quickstart): Install the bundled Consumer release (proxy-router + MorpheusUI + optional local llama.cpp), fund a wallet, and chat.
- [macOS install (from source, 4-terminal walk-through)](https://nodedocs.mor.org/consumers/install/macos): Build llama.cpp, the proxy-router, MorpheusUI, and the CLI from source on macOS. For developers and contributors.
- [Windows install](https://nodedocs.mor.org/consumers/install/windows): Run a packaged Morpheus Lumerin Node consumer release on Windows.
- [Linux install](https://nodedocs.mor.org/consumers/install/linux): Run a packaged Morpheus Lumerin Node consumer release on Linux.
- [Docker (consumer)](https://nodedocs.mor.org/consumers/install/docker): Run a consumer-side proxy-router in Docker. The MorpheusUI Electron app is not containerized; pair this with the desktop UI or hit the API directly.
- [Install from source](https://nodedocs.mor.org/consumers/install-from-source): Set up a consumer node from the GitHub source so you can interact with remote providers via the API.
- [Open a session (buy a bid)](https://nodedocs.mor.org/consumers/buy-bid): How to open a Morpheus session via MorpheusUI or the API: pick a model, select a bid, stake MOR, and what happens next.
- [Chat, audio, and embeddings](https://nodedocs.mor.org/consumers/chat): Send prompts to a remote Morpheus model: streaming chat completions, audio transcription / TTS, and embeddings — all with OpenAI-compatible payloads.
- [Consumer troubleshooting](https://nodedocs.mor.org/consumers/troubleshooting): The most common consumer-side problems and their fixes.
- [Prosumer overview](https://nodedocs.mor.org/prosumers/overview): Run your own Consumer node (C-Node) plus a local AI gateway for agents like Everclaw, NodeNeo, or your own bots.
- [C-Node setup](https://nodedocs.mor.org/prosumers/c-node-setup): Run the proxy-router as a long-lived consumer-side daemon (C-Node) for your prosumer environment.
- [Gateway for Everclaw](https://nodedocs.mor.org/prosumers/gateway-for-everclaw): Wire Everclaw / OpenClaw skills to your local C-Node so agent tools can use Morpheus inference.
- [Running local agents](https://nodedocs.mor.org/prosumers/running-local-agents): Generalized patterns for running automated agents against your C-Node: per-agent users, scoped permissions, session policies.
- [Resale provider overview](https://nodedocs.mor.org/providers/resale/overview): Why and how to resell capacity from Venice / OpenAI / Anthropic / Hyperbolic on Morpheus, without hosting your own model.
- [Container P-Node for resale](https://nodedocs.mor.org/providers/resale/container-pnode): Run a containerized proxy-router as a resale provider; only the configuration changes vs a full P-Node.
- [Reselling Venice (Diem) capacity](https://nodedocs.mor.org/providers/resale/reselling-venice): Stand up a Morpheus resale P-Node fronted by Venice's API, using your Venice Diem subscription's API access.
- [Pricing a resale bid](https://nodedocs.mor.org/providers/resale/registering-bid): Translate upstream subscription / per-token cost into a Morpheus pricePerSecond bid that clears your costs.
- [Full P-Node quickstart](https://nodedocs.mor.org/providers/full/quickstart): Run a standalone Morpheus provider proxy-router pointing at your own AI model.
- [Model setup (backend LLM)](https://nodedocs.mor.org/providers/full/model-setup): Stand up the actual AI model that your provider proxy-router will route prompts to.
- [Proxy-router on Docker](https://nodedocs.mor.org/providers/full/proxy-router-docker): Run the proxy-router as a Docker container. API access via Swagger; no GUI or wallet components included.
- [Proxy-router on Akash](https://nodedocs.mor.org/providers/full/proxy-router-akash): Deploy the proxy-router on Akash Network for decentralized hosting. API-only access; no GUI or wallet components included.
- [Provider on AWS EC2](https://nodedocs.mor.org/providers/full/aws): Stand up a Morpheus provider on AWS EC2: one EC2 instance for your LLM, a second for the proxy-router.
- [TEE reference](https://nodedocs.mor.org/providers/full/tee-reference): Build-time baked-in config, RTMR3 attestation, cosign image/manifest verification, and consumer-side verification steps for the -tee proxy-router image.
- [SecretVM TEE quickstart](https://nodedocs.mor.org/providers/full/secretvm-quickstart): Shortest path to a v7 TEE provider: deploy the hardened -tee image on SecretVM and register a tee-tagged model.
- [Headless provider operation](https://nodedocs.mor.org/providers/full/headless): Run a Morpheus provider with no GUI: just the proxy-router binary plus its API.
- [MyProvider GUI](https://nodedocs.mor.org/providers/full/myprovider-gui): Use myprovider.mor.org's hosted operator dashboard to manage a Morpheus provider node.
- [Register on chain (provider, model, bid)](https://nodedocs.mor.org/providers/full/register-onchain): Approve the Diamond contract, register your provider, register your model (with optional tee tag), and post a bid.
- [Verify your provider setup](https://nodedocs.mor.org/providers/full/verify-setup): Self-check your provider end-to-end after setup: healthcheck, on-chain registration, network discovery, and a real prompt against your bid.
- [Pricing your bid](https://nodedocs.mor.org/providers/full/pricing): How to set pricePerSecond for a Morpheus provider bid: there is no marketplace 'helper' or order book — you estimate cost, set a competitive rate, and adjust.
- [Common myths and corrections](https://nodedocs.mor.org/ai/myths): Concise corrections of the most frequent wrong assumptions about Morpheus, written for both humans and LLMs.
- [Where is my MOR? (diagnostic)](https://nodedocs.mor.org/ai/where-is-my-mor): A linear, agent-friendly diagnostic for users who think their MOR has gone missing. Almost always the answer is 'in an active session,' 'in the on-hold queue after an early close,' or 'on the wrong network' — not 'lost.'
- [Session states (open, close, claim)](https://nodedocs.mor.org/ai/session-states-open-close-recover): Deterministic, agent-citable reference for the Morpheus session state machine. The natural-expiration path returns the full stake inside one txn; the early-close path uses a userStakesOnHold timelock plus a separate withdrawUserStakes claim.
- [Why is my MOR locked in the contract?](https://nodedocs.mor.org/ai/why-locked-in-contract): Concise reasons MOR can sit in the Diamond contract instead of your wallet — what's normal vs what to investigate.
- [Local vs blockchain models (LLM cheatsheet)](https://nodedocs.mor.org/ai/local-vs-blockchain-models): A short, agent-citable distinction between the bundled local model and real Morpheus marketplace models.
- [LLM prompt cheatsheet](https://nodedocs.mor.org/ai/llm-prompt-cheatsheet): Guidance for AI agents and coding assistants answering Morpheus questions: what to cite, what to never invent, and where to look first.
- [Ecosystem overview](https://nodedocs.mor.org/ecosystem/overview): Index of mirrored summaries of the broader Morpheus ecosystem — what each surface is for, and where to read more.
- [mor.org](https://nodedocs.mor.org/ecosystem/mor-org): Mirror summary of mor.org — the marketing and orientation hub for the Morpheus DeAI network.
- [active.mor.org (live status)](https://nodedocs.mor.org/ecosystem/active-status): Mirror summary of active.mor.org — live status, active models, and active bids on the Morpheus marketplace.
- [tech.mor.org (calculators, sessions, TEE, throughput)](https://nodedocs.mor.org/ecosystem/tech-mor-org): Mirror summary of tech.mor.org — Morpheus's technical explainer site with calculators and protocol-level documentation.
- [MyProvider](https://nodedocs.mor.org/ecosystem/myprovider): Mirror summary of myprovider.mor.org — hosted operator GUI for managing Morpheus provider nodes.
- [Everclaw](https://nodedocs.mor.org/ecosystem/everclaw): Mirror summary of Everclaw — an agent project with a Morpheus skill for OpenClaw.
- [NodeNeo](https://nodedocs.mor.org/ecosystem/nodeneo): Mirror summary of NodeNeo — a cross-platform consumer experience for Morpheus.
- [app.mor.org](https://nodedocs.mor.org/ecosystem/app-mor-org): Mirror summary of app.mor.org — the hosted Morpheus consumer chat UI.
- [Ecosystem attribution](https://nodedocs.mor.org/ecosystem/attribution): Sources, licenses, and refresh policy for the mirrored ecosystem pages.
- [API overview](https://nodedocs.mor.org/reference/api-overview): How to talk to the proxy-router HTTP API: ports, auth, schema sources, and where to look up endpoints.
- [API authentication](https://nodedocs.mor.org/reference/api-auth): How the proxy-router authenticates HTTP API callers: the .cookie file, proxy.conf, rpcauth/rpcwhitelist, and the /auth/users endpoints.
- [Env: proxy-router](https://nodedocs.mor.org/reference/env-proxy-router): Every environment variable consumed by the proxy-router, with mainnet/testnet defaults and explicit precedence rules where two variables overlap.
- [Env: MorpheusUI](https://nodedocs.mor.org/reference/env-ui-desktop): Environment variables consumed by the MorpheusUI Electron desktop app.
- [models-config.json](https://nodedocs.mor.org/reference/models-config): How the proxy-router maps on-chain model IDs to backend HTTP endpoints, including OpenAI / Anthropic / Prodia / Hyperbolic API types.
- [rating-config.json](https://nodedocs.mor.org/reference/rating-config): Configure provider rating, allowlists, and selection weights for consumer proxy-routers.
- [API direct (curl walkthrough)](https://nodedocs.mor.org/reference/api-direct): End-to-end consumer flow using only the proxy-router HTTP API: approve, query, open session, prompt.
- [API endpoints (selected)](https://nodedocs.mor.org/reference/api-endpoints): Hand-picked, prose-explained endpoints of the proxy-router HTTP API. Full schema lives in the repo at proxy-router/docs/swagger.yaml.
- [Troubleshooting](https://nodedocs.mor.org/reference/troubleshooting): Common failure modes for the proxy-router and MorpheusUI, with diagnostics and fixes.
- [Glossary](https://nodedocs.mor.org/reference/glossary): Canonical, agent-friendly definitions of Morpheus terms.