@xynqai/plugin-eliza

ElizaOS plugin for XYNQ — decentralized inference, live GPU mesh status, and the USDC worker earnings story.

| Component | What it does | | --- | --- | | Models | Registers TEXT_SMALL / TEXT_LARGE → https://xynq.ai/v1 (xynq-1, xynq-glm-5.2) | | Provider | Injects live mesh stats + billing/worker context into agent state | | Actions | CHECK_XYNQ_NETWORK, XYNQ_WORKER_GUIDE, XYNQ_TOPUP |

Install

In your ElizaOS project:

npm install @xynqai/plugin-eliza
# peer dependency (you likely already have this)
npm install @elizaos/core

Or link locally while developing:

cd plugin-eliza && npm install && npm run build
# in your agent project:
npm install ../path/to/xynq/plugin-eliza

Configure

Add to your character's plugins array and settings:

{
  "plugins": ["@xynqai/plugin-eliza"],
  "settings": {
    "XYNQ_API_KEY": "xynq_sk_...",
    "XYNQ_API_BASE": "https://xynq.ai/v1",
    "XYNQ_ORCH": "https://xynq-network-production.up.railway.app",
    "XYNQ_SMALL_MODEL": "xynq-1",
    "XYNQ_LARGE_MODEL": "xynq-glm-5.2"
  }
}

Or via environment:

XYNQ_API_KEY=xynq_sk_...
XYNQ_ORCH=https://xynq-network-production.up.railway.app

Get API keys at xynq.ai → Account.

See character.example.json for a full starter character.

Usage in code

import { AgentRuntime } from "@elizaos/core";
import xynqPlugin from "@xynqai/plugin-eliza";

const runtime = new AgentRuntime({
  character: myCharacter, // must list @xynqai/plugin-eliza in character.plugins
  plugins: [xynqPlugin],
});

await runtime.initialize();

Actions (what users can trigger)

| Action | When the agent uses it | | --- | --- | | CHECK_XYNQ_NETWORK | "How many GPU workers are online?" | | XYNQ_WORKER_GUIDE | "How do I earn USDC with my GPU?" | | XYNQ_TOPUP | "How do I top up XYNQ credits?" |

Each action includes few-shot examples so the LLM learns when to invoke it.

Crypto narrative

• Workers connect with npx @xynqai/worker --wallet <SOLANA_ADDRESS> and earn for serving inference.
• Developers use xynq_sk_ keys; 1M free tokens/month, then USDC on Solana top-ups.
• Provider pulls live /stats from the coordinator so the agent always knows mesh capacity.

Build from source

npm install
npm run prepare:images   # logo-source.png → images/logo.jpg + banner.jpg
npm run build

Registry assets live in images/ (400×400 logo, 1280×640 banner). Replace images/logo-source.png with your artwork and re-run prepare:images.

ElizaOS registry listing

After npm publish, open a PR against elizaOS/eliza adding registry-entry.json as packages/registry/entries/third-party/xynqai__plugin-eliza.json, then regenerate the registry per their README. Or run elizaos publish from this folder (requires npm + GitHub auth).

Related

• API: xynq/API.md
• LangGraph examples: examples/langgraph-xynq
• CLI (network mesh): @xynqai/cli