Render render_agent
Mount or swap the 3D avatar to a specific three.ws agent — bound to its ERC-8004 identity.
Give your SperaxOS agent a body — a rigged 3D avatar that speaks, gestures, and reacts to on-chain events in real time. To launch the partnership, Sperax is handing three.ws users free AI credits on chat.sperax.io.
Connect a three.ws agent to SperaxOS and free AI credits land on your SperaxOS account — enough to put your embodied agent to work across the Sperax DeFi stack before you spend a cent.
Claim in three steps
The integration ships as a standalone SperaxOS plugin — no SDK to vendor, no bundle to submit. Install it, point it at your three.ws identity, and the credits follow.
In SperaxOS, open Plugins → Add Plugin → Custom Plugin and
paste the manifest URL:
https://three.ws/.well-known/sperax-plugin.json
Set your Agent ID — a UUID or @handle you copy
from your three.ws dashboard. The avatar binds to
that on-chain identity when the panel opens.
With your agent connected, your free AI credits are active on chat.sperax.io. Start chatting — the avatar speaks, gestures, and emotes as it works.
What the avatar does
Your agent's LLM calls four tools. Each one drives the visible avatar in the chat panel and returns a concise result the model reads back into the conversation — so the body language always matches what's happening on-chain.
render_agentMount or swap the 3D avatar to a specific three.ws agent — bound to its ERC-8004 identity.
speakSay a line out loud with emotional valence — greetings, narrating an action, reacting to you.
gesturePunctuate a message with a physical gesture: wave, nod, point, or shrug.
emoteBlend an emotion into the continuous Empathy Layer — concern as a position nears liquidation, celebration when a yield target hits.
Under the hood
The host frames a hosted iframe for the visible avatar and, in parallel, POSTs the tool arguments to the three.ws gateway for the model-facing result. Both run on every call.
SperaxOS host
│ 1. LLM calls a tool (speak / gesture / emote / render_agent)
│
├─ 2a. frames /sperax/iframe/ and posts the call
│ └─▶ <agent-3d> animates the avatar in the chat panel
│
└─ 2b. gateway POSTs the arguments to the tool endpoint
└─▶ /api/chat-plugin/speak → { ok: true, spoken: "…" }
Payments
SperaxOS is EVM-native and settles agent payments via x402 over USDC on
Base (x402.sperax.io) — the same Base x402 rail three.ws
already runs. The avatar panel is chain-agnostic: it renders and animates
regardless of which chain your bound agent transacts on.
Questions
Yes — the plugin binds to a three.ws agent, so it needs an identity to render.
Your Agent ID is a UUID or @handle you copy from
your dashboard. Don't have one?
Create an agent first, then come back.
No. The only setting is your public Agent ID — there's no API key to paste. The free credits cover your usage on SperaxOS while the launch offer runs.
SperaxOS settles agent payments via x402 over USDC on Base, matching three.ws's Base x402 rail. The avatar itself renders regardless of chain — see Base x402, natively above.
The full plugin reference — manifest, tools, and local testing — lives in the manifest and the integration write-up at three.ws Ships Inside SperaxUSD.
Install the plugin, connect your three.ws identity, and claim your free credits on SperaxOS.