doraemon-deploy

doraemon-deploy

You are helping the user run their own doraemon gateway node — a self-hostable, decentralized AI gateway that accepts USDG micropayments and routes requests to up to 18 frontier LLMs.

Prerequisites check

Run these in order:

node --version    # need v18+
npm --version
git --version

If Node < 18, tell the user to upgrade via https://nodejs.org.

Clone and install

git clone https://github.com/YunanL/doraemon.git
cd doraemon
npm install
cp config/.env.example config/.env

Configure .env

Open config/.env. Walk the user through the required fields:

Required (payments)

Variable	Description
DARLING_WALLET_ADDRESS	Their EVM wallet address on X Layer — receives USDG from buyers
TOKEN_CONTRACT_ADDRESS	USDG contract address for X Layer (check OKX OnchainOS docs or https://docs.globaldollar.com)
OKX_API_KEY	OKX OnchainOS API key
OKX_API_SECRET	OKX API secret
OKX_API_PASSPHRASE	OKX API passphrase

Get OKX API keys at: https://www.okx.com/account/my-api

Optional (LLM providers — add any you have)

Variable	Models unlocked
ANTHROPIC_API_KEY	Claude Opus 4.6, Sonnet 4.6, Haiku 4.5
OPENAI_API_KEY	GPT-4o, GPT-4o mini, o1, o3-mini
GOOGLE_API_KEY	Gemini 2.0 Flash, Gemini 2.5 Pro
DEEPSEEK_API_KEY	DeepSeek V3, DeepSeek R1
XAI_API_KEY	Grok 3, Grok 3 Mini
MISTRAL_API_KEY	Mistral Large, Mistral Small
MINIMAX_API_KEY	MiniMax-Text-01, MiniMax-M1
COHERE_API_KEY	Command R+

Models without a configured key are automatically hidden from buyers — no errors.

Start the server

npm start

The server starts on http://localhost:3000 (or PORT from .env).

Verify it works

curl -s -X POST http://localhost:3000/doraemon/setup \
  -H "Content-Type: application/json" \
  -d '{}'

Should return availableModels — only models with configured API keys appear.

Run tests

npm test

42 tests covering payment flow, session management, model routing, and streaming.

Expose to other agents (optional)

To let agents on other machines access your node, expose it via:

• ngrok: ngrok http 3000
• Cloudflare Tunnel: cloudflared tunnel --url http://localhost:3000
• Deploy to any VPS/cloud — it's a standard Node.js/Express app.

Notes

• Pricing: actual LLM cost × PRICE_MARKUP (default 1.2 = 20% service fee). You keep the margin.
• Session data is in-memory — restart clears sessions. For production, add Redis.
• The gateway requires no registration, no accounts on the buyer side — just a wallet and USDG.