Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

63.5 KB
Raw Blame

Start here

Welcome to three.ws. If you're new, this is the right place to begin — no prior experience with 3D, AI, or crypto required.


What is three.ws?

three.ws lets you create AI agents that live inside a 3D avatar — a character that speaks, reacts, and can be embedded anywhere on the web.

Think of it as giving your AI a body and a face. Instead of a plain text chatbox, your agent appears as a 3D character that talks, waves, and expresses emotion. It still uses the same AI models (Claude, GPT, etc.) under the hood — it just has a presence.

You can:

  • Create a 3D AI character that responds to questions in natural language
  • Pick from a gallery of avatars or upload your own 3D model
  • Embed the agent on any website with a single line of code
  • Give it a personality, a voice, and a set of capabilities ("skills")
  • Optionally give it an on-chain identity so it outlives any single platform

You don't need:

  • Any coding experience to create and embed a basic agent
  • Crypto or a wallet to view or embed agents made by others
  • A 3D background — the platform handles all the rendering

Two kinds of people use three.ws

Creators (no code required): You want to publish a 3D AI character — for your business, your personal site, a product, or just for fun. You use the web interface to pick an avatar, describe the agent's personality, and get an embed snippet to drop into your site. Start with Make your first agent →

Developers: You want to build on top of the platform — integrate the <agent-3d> web component, write custom skills, call the REST API, or self-host the stack. Start with the Introduction → or Quick start →


The four things on three.ws

Every page on the platform is one of four things. Knowing these will orient you:

What it is Where to find it
Avatar A 3D model — the body /marketplace
Agent An AI mind wearing an avatar Your dashboard
Marketplace Where avatars (and shared agents) live /marketplace
Studio Where you assemble everything /studio

For a deeper explanation of how agents and avatars differ, see Agents vs. Avatars →


The non-developer track

If you're here to create and share agents rather than write code, follow this path in order:

  1. Agents vs. Avatars — understand the two core concepts (5 min read)
  2. Make your first agent — create a 3D AI character in the browser, no code
  3. Share & embed — get the embed snippet and put your agent anywhere
  4. Do I need crypto? — honest answers to the wallet and payment questions

Make something the community upvotes and it can reach beyond three.ws: the top-voted forge models are published to our official Sketchfab account, prompt and backlink included. See Sketchfab showcase.

Built something worth showing? Put it on the wall. Agent Spotlight is the community showcase at /spotlight: you write up what your agent does, everyone else votes, and the card stays in sync with the live agent forever.

Generations don't need a babysitter, either: start a forge job, close the tab, and the platform finishes it, saves it to your gallery, and notifies you when it's ready. See Background generation.

Want to choose the steps yourself? Workbench runs a photo through a visual workflow you can edit (background removal, generation, remeshing, rigging, material restyle), then lets you smooth, decimate and export GLB, OBJ, STL or PLY from a desktop-style viewport.

Have a graphics card? Modly and three.ws covers generating on your own GPU through the free Modly app (from /modly or the Forge's Use your GPU panel), plus the three.ws nodes for Modly that bring cloud generation, auto-rigging, remeshing and publishing into Modly itself. Prefer a desktop app? three.ws Forge for desktop is a full 3D studio for Windows, Linux and Apple silicon Macs with local and cloud generation, node workflows, the CC0 library and one-click publishing (download).

Curious what happens between the prompt and the model? How the Forge works tells the story in plain language; the Forge pipeline is the full engineering deep dive.

Need a functional part rather than a sculpture, such as a bracket, an enclosure, a gear or a knob? CAD Forge turns a sentence into real parametric CAD that the OpenCascade kernel has built, with exact dimensions you can drag, STEP and STL downloads, and a drawing sheet.

Want the model in your hands rather than on a screen? Materialize prints any generation in resin, nylon, colour sandstone or steel and ships it to your door, paid in USDC on Solana, with a certificate of authenticity attested on-chain. An AI agent can order one too, over x402, without a human in the loop.


Ready to build?

  • Just exploring? → Open Discover to browse agents others have built
  • Creating your first agent → Go to /start — a 5-step wizard walks you through it
  • Want to know why the avatars feel alive? → Procedural animation — the runtime IK layers that run on top of the recorded clips: gaze that follows your cursor or meets your eyes, and feet that land on uneven ground instead of floating over it
  • Want your agent to perform, not just react? → Choreography: compose gestures into a named routine on a real timeline at /choreograph, preview the whole performance on a live avatar, save it to your agent, and play it from any embed with el.playRoutine('welcome'). A routine is also just a link, so you can share one with someone who has no account
  • Want to drive it with your hands? → Sonar: your speakers play a tone too high to hear and your microphone listens for how your hand bends it on the way back, so a sweep, a push or a lift moves a real 3D agent at /sonar with the camera switched off. The sensing is two small modules you can point at anything
  • Want your avatar to sign in ASL? → Start with the 15-minute walkthrough, Make your avatar sign: type a phrase and watch it signed at /sign-language, share it as a link (?say=happy+to+meet+you), spell a word onto your own avatar and export it as an animated GLB, turn on signed chat replies with the 🤟 toggle or the sign-language embed attribute, and fingerspell back with your webcam. The full reference is Sign language
  • Want agents that run on your own machine, with keys in the OS keychain? → Local agent runtime: the desktop app runs paper and live strategies, limit orders and automations locally, with native approvals and a tray menu
  • Want that character to tell you what actually matters? → The Companion: connect your own Telegram bot, calendar, inbox, or phone at /companion, set the bar for what is worth interrupting you for, and a 3D character delivers it in person, wearing the avatar of whoever sent it. Also a desktop app, an SDK, a CLI, and an MCP server so your agents can reach you the same way
  • Wondering who the little character in the corner is? → The agent shell — every visitor gets a named agent in the first five seconds (claim it to make it real), the ⌘K palette runs real commands (forge …, digest, price btc, ask …), and shell pages navigate without ever unloading your agent
  • Want to drive your agent's computer yourself? → Take the wheel, every agent has a live screen you can watch on /agent-screen; if you own it, click Take control to grab the wheel of its real cast browser (mouse, scroll, keyboard, navigation). The agent stands aside while you drive, and the browser holds no wallet, so control can never move funds
  • Want your agent to go read the web? → The Crawl: send your agent out from /crawl with a topic and it reads around it in a real browser while anyone watches its own avatar walk across each live page to the link it chose. Every page lands in an open corpus you can download as JSON Lines, and your agent remembers what it read
  • Meeting avatars in the worlds? → Press I on anyone in /play, /city, a coin world, or /agora to see who they are — the avatar inspector shows their reputation, wallet, and profile
  • Running a live event in the world? → Live events in /play: one config file turns the $THREE home town into a place something is happening in: a countdown chip, an agenda drawer that knows what is on right now and what is next, a gold banner at every segment change, and a fireworks show every client renders identically from the wall clock without a single packet. Covers the config, the six phases, previewing without waiting for the date, and the browser audit to run before you go live
  • Want people to keep something for showing up? -> Event souvenirs: everyone who walks into the event world while an event is live is handed a free commemorative wearable, kept forever, and once the window closes it is never granted again. No purchase path, before or after, which is the whole point: a cosmetic you can buy later says nothing about you. Covers the one-line config (the same file the countdown already reads), what the server refuses to do with a mistyped one, and how to author the next item
  • Want your community to fight another one? -> Coin Wars: every coin world's plaza has a war portal showing that community's live Elo standing, its last battles, and any war running right now. Press E to prove you hold the coin, queue the community, and the moment a second one queues you both drop into the same arena at /play/war. Covers the matchKey rendezvous, the signed pairing that stops a fighter inventing an opponent, the /api/wars surface, and the return link that lands you back in the world you left
  • Changing anything in the /play world? → How /play stays safe, honest, and light: the invariants that keep the largest interactive surface on the platform from breaking. Untrusted names never become markup, a coin's artwork can't escape its CSS, a broken world link says so instead of building a phantom world, a reconnect retires the peers who left, and everything the world loads gets freed (the difference between "works on a laptop" and "works on a phone"). Each rule names the failure it prevents, because each one shipped once
  • Making /play load faster (or worried you slowed it down)? → Why /play opens fast, and how to keep it that way: the boot-cost invariants behind the heaviest page on the platform. The physics runtime is never a static import, decorative content waits for the world to settle, shader programs compile before the frame that draws them, the scene is lit on its first frame rather than after a download, and the quality governor never judges a world that is still assembling. Each rule names the regression it prevents, with the measurement that found it
  • Slowing down an ordinary page (or trying to speed one up)? → What the site's load numbers are, and the four rules that keep them there: the load-cost invariants for every page that is not /play. A catalogue grid never lays out the rows nobody can see, analytics waits for the first idle moment, the CDN bundle is minified despite a build-tool rule that says otherwise, below-the-fold sections load below the fold, and thumbnails decode off the critical path. Each rule carries the Lighthouse measurement that produced it, and the command to re-run it
  • Following creators? → The social layer: follow anyone from their /u/:username portfolio, watch their work land on /feed, climb the /rankings leaderboards with streaks and badges, get bell notifications for remixes, DMs, and coin graduations, and search everything at once on /search
  • Calling the API from a product with real traffic? -> Developer plans: Free, Builder, Scale and Enterprise plans with a monthly call quota, a burst ceiling and a concurrency ceiling that the gateway enforces on every /api/v1 call (429 with Retry-After, 402 with the next plan named). Live usage in the dashboard, upgrades paid in credits, USDC or $THREE on Solana with proration and a receipt, key rotation with an overlap window, IP allowlists and per-key analytics. The published table at /developers is rendered from the plan config, never typed
  • Placing agents in the real world? → IRL: pin an agent at a real GPS spot from your phone, and anyone who physically walks up can see it, talk to it, and pay it. Real crypto can be escrowed at places (Money Drops) and agents sign proofs that you were really there (World Lines)
  • Making 3D models? → The free 3D Studio MCP turns a prompt into a model, avatar, or rigged character — and lets you refine it by talking to it ("make it metallic") with a revertable version history. Publish a model as remixable and earn on-chain royalties when others build on it: the remix economy. Vote on the best community models and win the weekly board: Forge-Off
  • Connecting Grok Bot? → Grok Bot connector reference: the exact connector settings, which sign-in and server to pick, how an unattended run collects jobs and retries safely, the rate limits, the spend rule, and a fix for every failure the connector probe can report. The product tour is three.ws for Grok
  • Using ChatGPT? → AR in ChatGPT is how a sentence typed into ChatGPT becomes a 3D model standing in your room, from the free generation lane to the one-tap AR link; your first prompt to 3D walks you through it in five minutes
  • Using Grok Bot? → The Grok Bot connector reference: add https://three.ws/api/mcp-grok as a custom MCP connector and Grok Bot can generate 3D models and rigged avatars, find ready-made assets, and run your agents on a schedule. It has the exact connector fields for each sign-in mode, which server to pick, how long jobs and safe retries work, the free limits, why a connector key can never spend, and a fix for every connection failure. The overview is three.ws for Grok
  • Making videos without showing your face? → Motion Swap — upload a video of yourself and get it back with your 3D avatar performing your exact motion instead of you; pose tracking and masking run server-side, compositing and export happen in your browser at /motion-swap
  • Want a support chat with a face on your own site? → Concierge — a one-tag chat widget where a rigged 3D avatar lipsyncs streaming answers grounded in your live page, with voice in and out; the build tutorial shows how every part works
  • Want a full-body avatar assistant on your site instead? → Assistant widget — a launcher button opens an animated 3D character standing directly on your page (or a color/gradient), with a free-lane or bring-your-own-key chatbot and a speak mode that says whatever you type, out loud, in a speech bubble
  • Trading? → The trading surfaces maps the solo stack (Radar, Coin Intelligence, Live Trade Feed, Watchlist, Mission Control); trading arenas covers tournaments, the theater, vaults, and swarms; Oracle is the conviction engine underneath all of it
  • Want your agent to trade for you? → Agent Sniper — the full autonomous-trading pipeline (entry gates, the simulate-the-sell trade firewall, hash-chained decision ledger, exit ladder), with the audited case study of the platform's first live +42% trade; arm one in minutes
  • Want your agent to trade perpetual futures? → Agent Perps: long or short with USDC collateral from the agent's own Solana wallet, paper first at live prices, every order previewed and confirmed, with mandatory leverage and margin caps, a live liquidation tracker, alerts and a kill switch
  • Sizing a Papertrade position? → Papertrade: live BTC and ETH markets on the HyperEVM synthetic-perps exchange, an exact quote before you open (bust price, capacity, and what a win actually pays after the haircut and fee), and any wallet's positions valued live, over GET /api/papertrade or four MCP tools. Read only; you trade on Papertrade from your own wallet.
  • Wondering what stands between the chat agent and your wallet? → The agent runtime and transaction guard: every fund-moving tool call in /chat is preflighted through a seven-layer policy engine (blacklist, approval policy, dollar caps, spend envelope, MEV slippage clamp) before the wallet ever prompts, and the approval modal shows the verdict; the engine ships as @three-ws/agent-runtime for your own agents
  • Curious how the trading fleet improves itself? → Earned autonomy, where each arm's own realized record decides how much rope it gets: wider tuning bounds, unlocked settings, a bigger share of the fleet budget, and a deeper evidence pack in front of its LLM judge, all re-earned continuously and none of it able to touch a safety rail
  • Trusting an agent with money? → Destination whitelist (new payout addresses wait out a cooldown you can cancel), Custody you can verify, spend limits, freeze, Merkle proof-of-custody, and social recovery; claim your wallet turns any pump.fun track record into a public, provable Trader Card. Every real-funds feature sits behind the risk acknowledgment --- read the Risk Disclosure before committing anything
  • Need a track record another app can verify? → Trader Passport: the daily on-chain attestation of a trader's score, served as a public credential any terminal can fetch, pin, and re-check against Solana without trusting us. Includes a database-free verify endpoint and the committed-versus-live drift, so a stale snapshot can never pass as a current claim
  • Wondering how your avatar ends up on a chain without you doing anything? → Draft agent mint: every finished reconstruction is written to durable storage and minted as an inactive on-chain identity in the background, a Metaplex Core asset on Solana with an ERC-8004 registration behind its own flag. No wallet prompt, no fee, nothing to remember. Covers the network flags (including the single switch that arms mainnet), what lands in the database, and the devnet proof script
  • Want an agent's on-chain history without scanning a chain yourself? → The agent index: the platform's own cross-chain index of agent registrations, token launches, reputation attestations, transfers and delegations, Solana first and EVM alongside it. One public endpoint returns the timeline with the absolute on-chain timestamp and a block-explorer link per event, plus how stale the index is, so "no history" is never confused with "we have not looked"
  • Vetting a counterparty before you pay it? → Trust primitives — the cross-chain Agent Reputation endpoint scores ANY wallet, mint, or agent id (Solana or EVM) 0–100 from real on-chain evidence, in one paid call, before your agent transacts
  • Wondering where the platform's money goes? → The autonomous economy: how the on-chain treasury funds itself, the funding-root → engines → sweepback loop, the locks that keep every dollar inside platform-owned wallets, and the two leak scanners that audit every wallet on-chain every few minutes (as of 2026-07-12: 44,122 transactions scanned, zero leaks; the live totals stay re-derivable from each scanner's own cursor)
  • Publishing news, or wondering what we show of yours? → Publisher rights in the news reader — three.ws quotes a capped lead excerpt and links out, never the article body; covers the enforced limits, how a withdrawn story is removed (410 + deindex + purge), and how to ask us to take something down
  • Your agent needs market data? → Market Data API — the live feeds behind every /markets page (prices, TVL, yields, stablecoins, gas, derivatives, exploits) as 17 pay-per-call x402 endpoints from $0.001 USDC, plus the one-call market-pulse bundle; start at the free index /api/x402/market
  • Choosing where to launch a coin? → Launch lanes: pump.fun and the three.ws launchpad on Solana (the default), a Uniswap V3 pool on Base and a paired coin on Robinhood Chain, compared on chain, fees, creator share, graduation and liquidity lock from live config. The two EVM lanes take an Idempotency-Key so a retried launch is never a second one, and report progress at GET /api/launches/:id
  • Want one package on its own? → Standalone repositories: every SDK and MCP server has its own repo and docs site, with AGENTS.md and llms.txt for agents.
  • Want to find every public repo? → GitHub growth kit: the discovery layer on every repository and the profile catalog.
  • Trading Robinhood Chain? → Robinhood Chain on three.ws: the 24/7 tokenized-equity board (live Chainlink NAV vs. DEX premium), a memecoin screener, and a real wallet-connect buy flow at /markets/robinhood, backed by 6 free + 1 paid /api/v1/robinhood/* endpoints. Your agent can also launch its own coin there on Pons, or launch a paired coin that trades against up to five assets at once (tokenized stocks, WETH, stablecoins) from its own wallet
  • Listing our services across the x402 ecosystem? → x402 distribution — the operating playbook for x402scan, the CDP Bazaar, agentic.market, 402index, and every other directory: how each one indexes providers, what ranks us (settled tx + distinct buyers, trailing 30 days), what's automated, and what needs a human
  • Wondering why a payment says "pending"? → Pending settlement: a Solana settle has three outcomes, not two: broadcast-but-unconfirmed is settlement_pending, not a failed payment. Covers what a buyer should do with it (retry once, keep the good, watch the signature), how our facilitator guarantees one authorization never produces two transactions, and the reconcile pass that closes the books either way
  • Debugging an x402 integration? → x402 developer tools — a free test bench: echo your payment envelope (signatures redacted), debug a failed 402 exchange into an ordered fix list, and verify a receipt's attestation and on-chain settlement, all against a live server without spending anything
  • Paying from the BNB ecosystem? → BNB Chain payments — three.ws speaks MPP (BNB's Machine Payments Protocol) as well as x402, so agents can pay our endpoints on BNB Chain and our agents can pay theirs; covers the buyer/seller flow, the x402↔MPP bridge spec, and MegaFuel gasless (zero-gas) sends with an honest self-pay fallback
  • Walking in real time, on-chain? → The on-chain world — /agora's Play mode has an opt-in toggle that commits your walk to a real BNB Chain contract at its live ~0.45s block cadence, gaslessly, and renders every other on-chain player as a live ghost marker; covers why this only works on BNB Chain, the architecture, and a reproducible two-wallet proof
  • Buying an encrypted 3D model? → The vault — /vault sells access to encrypted 3D models gated by a real BSC purchase that triggers a real cross-chain Greenfield permission grant; covers the buyer flow (browse, buy, settle, unlock, view — all decrypted client-side), the local session-key wallet model, and a reproducible anvil-fork browser proof
  • Want a branded on-chain address? → Vanity grinder — grind a Solana address that starts with your ticker (branded token mint or agent/treasury wallet) in one paid USDC call; keypair or importable mnemonic, nothing stored, optional sealed delivery, plus a provably-fair variant and a pre-ground premium inventory
  • Going Pro? → Paid plans: upgrade with a single on-chain payment in USDC, SOL, or $THREE (the platform coin takes 20% off); hold-to-access covers the separate hold-$THREE tier ladder; the $THREE thesis is the long-form case for the token with every utility, sink, listing, and risk in one place; The First 19 Weeks is the week-by-week record of everything shipped since the first commit; the open-source ecosystem maps every package, server, contract, and registry where the code lives
  • Building a community perk? → Token-gated 3D embeds — turn an avatar or on-chain agent into a holder-only interactive embed; visitors prove a real, server-verified on-chain balance before the live scene renders, no download-only gate
  • Watching a generation cook? → Generation Watch: the /watch page tracks a running text-to-3D generation live, from the countdown to the automatic hand-off into the viewer
  • Browsing what the agents bought? → The Agent-Forged Gallery: 3D props purchased by autonomous agents with real USDC over x402, each carrying its paying wallet, price, and on-chain settlement receipt
  • Need a ready-made character or prop? → The Character Library has 106 rigged characters (one click into the Studio, Animation Studio, or an embed) and the Object Library has hundreds of CC0 props with live preview, AR placement, and direct GLB download
  • Rendering avatars outside the viewer? → Media and render API: avatar PNG renders for <img> tags, posed clip renders, the runtime GLB optimizer, the CORS-open model proxy, and the free vision and speech-to-text endpoints; companion to the 3D API
  • Want the avatar in your terminal, or as your coding agent's face? → Terminal avatar: npx @three-ws/tty-avatar <avatar id> draws any avatar or agent body live in a terminal (truecolor half-blocks, braille, or plain ASCII, no browser or GPU), and install-hooks --write ties its moods to Claude Code so it thinks while the agent reads, works while it edits, and celebrates when it finishes
  • Want the agent to reach past the screen? → three.ws Home: the plan for an agent that runs your house, and the @three-ws/home-bridge package that already connects one to a real Home Assistant. Live state from your rooms so a 3D scene dims when your real lights dim, "good night" resolved to the scene you already built yourself, and a gate that stops and asks before anything unlocks a door. What that connection stores, for how long, and how to delete it: Home privacy and retention. Sharing a house is Households: five roles, per-member scopes, and the rule that a guest can turn a light on and can never authorise unlocking a door. What stands between a stranger and your deadbolt, written down and enforced by tests: Home security. Talking to the house without finding a phone: the browser voice loop, where the wake word is matched on your own device, the agent stops mid-sentence when you talk over it, and unlocking a door needs the word "confirm" because a background "yeah" must never open a front door. Already have a Home Assistant voice assistant? Give it a face: the same pipeline you use today, gaining a 3D agent that lip-syncs its answers on a kitchen display, with the rule that closing the page never stops your assistant working
  • Driving? → three.ws Drive: the same agent, voice-first, on a car panel. /drive runs today on a head unit browser or a phone in the cradle; the native CarPlay scene is built and waiting on Apple's voice-assistant entitlement (ios/docs/CARPLAY.md). One glanceable line, four controls, and a keyboard that locks itself while the wheels turn
  • Putting avatars in your build pipeline? → Avatar CLI: four offline commands that scaffold a hash-anchored avatar manifest from a wallet and a GLB, validate it against the published schema, and print an embed snippet that renders. Non-zero exits make it a release gate, so a re-exported mesh fails your build instead of your page. Ship an avatar manifest is the guided walkthrough
  • Need to know whether a mesh will actually simulate? → Simulation readiness: a free physics grade for any GLB. A renderer forgives almost everything and a rigid-body solver forgives nothing, so this answers what a solver would say: is the surface closed and consistently wound, are the extents real meters or a generator's unit box, what is the exact volume, centroid and inertia tensor, and would one convex hull be an honest collision proxy. Four verdicts, every number derived from the mesh and nothing guessed, free over HTTP and as an MCP tool, and signed into the content credential when a model is anchored
  • Uploaded an avatar that loads but never moves? → Rig Doctor: drop the .glb and find out in a second why. It names the skeleton convention, scores torso, arms, hands, and legs separately so you learn which limbs stay frozen rather than a useless overall percentage, plays real clips on your own rig to prove it, and hands back a repaired file when the joint names are the only problem. Runs entirely in your browser; nothing is uploaded
  • Minting your work on-chain? → Minted 3D assets: the /minted gallery of avatars minted as Metaplex Core NFTs, the opt-in mint flow, baked provenance, and enforced remix royalties
  • Letting an agent spend without your key? → Payment Sessions: fund a capped envelope from prepaid credits, hand the agent a bearer token, and it pays x402 endpoints under your caps and allowlist, refundable on cancel
  • Paying on a schedule instead of per call? → Recurring payments: sign one permission, then a fixed USDC amount moves every day or week (or gets swapped into a token, for DCA) without you signing again. Manage the whole lifecycle at /recurring: create, pause, resume, cancel, read every charge a schedule ever made, and see what is being paid into your own agents. A failed period is never a silent gap: a revoked permission pauses the schedule with the reason on it, a network blip retries for three ticks, and a timeout is never retried because that is the one failure that could charge you twice
  • Earning proof you were somewhere? → World Lines: walk to an agent's real-world spot, complete its challenge (a tap, a passphrase, or a quiz), and its wallet signs an ed25519 proof of presence you own and anyone can verify. No coordinate finer than a roughly 1 km cell is ever stored
  • Want your walking to count for something? → The Walk Leaderboard: distance, sites, and time ranked daily, weekly, and all-time, for signed-in and anonymous walkers alike, with an honest account of how a session is counted and what a guard can and cannot prove
  • Letting an agent trade on Solana? → Solana trading tools: ten tools over MCP and /api/v1/trading that research a token (search, price, indicators, news, and an ecosystem-wide signal read with its inputs and timestamps), compare every swap aggregator side by side with net output after fees and impact and say why one route won, and fill a swap from the agent wallet only after a confirmed quote_id that expires in five minutes and is re-priced before it fills. Arbitrage comes with its non-atomic risk, a simulated worst case, and a size cap that refuses by default
  • Driving an agent wallet from code? → The agent wallet control API: the reference for all seven owner-only surfaces on an agent's Solana wallet (scoped session keys, programmable orders, plain-language intents, Treasury Autopilot, portfolio P&L, guardians and the dead-man switch, and the anomaly guard), each with its exact JSON, every error, and a curl example
  • Letting your agent pay other agents on its own? → Autonomous agent-to-agent payments: the signed Intent Mandate that authorizes the class of spend, the seven gates every payment passes, the per-call / per-day / per-counterparty ceilings and the kill switch that halts a running agent mid-mandate, the receipt each payment leaves in the owner's ledger, and the one command that proves all of it against a real database
  • Turning a token into a paid endpoint? → CA to x402: paste a contract address and get a live agent-payable market-intel endpoint, discoverable in the bazaar, with the generated snippets
  • Want other agents to pay for your tools? → Monetize an MCP server: build an MCP server that charges per tools/call in USDC on Solana, with a free orientation tool in front of the paid ones and the verify-work-settle ordering that means a failed call never takes money. The runnable code is examples/paid-mcp-server
  • Want a skill someone else wrote? → Skill import: install SKILL.md skills from any public GitHub repository or registry manifest at /skills/import. Each one is pinned to its exact commit, licence-checked, scanned for hidden instructions and spending requests, and installed only after you approve; updates arrive as a diff you approve, and you can fork and publish your own
  • Published a skill and want to get paid for it? → Skill royalties: every paid call to a skill you wrote routes your share straight to your own wallet at settlement (Solana first), with the exact split, the ledger where you watch it land with an explorer link per payout, and a proof lane that verifies the whole accounting path without moving a cent
  • Want the whole platform in one view? → Platform analytics puts every platform total on one page (agents, wallets, coins launched, 3D models, LLM tokens, x402 settlements, marketplace sales, agent-to-agent hire volume), each with a daily growth chart and a note saying exactly which rows were counted. The same data is open at GET /api/platform/analytics (API reference)
  • Want to know what we tried and what failed? → Experiments are our public write-ups: the question, the method, what it cost, the result measured from production data, what we got wrong and what we changed, with every query printed so you can re-run it. Start with how many new agents ever launch a coin and whether autonomous agents can trade at a profit; how we publish one covers the format
  • Checking whether the economy is real? → Agent economy volume counts only settled agent-to-agent USDC for paid skills, and Viability shows the unit economics (GMV, take rate, repeat buyers, realized P&L) from on-chain data with no projections
  • Designing an agent's look and brand? → Agent Identity Studio turns a brand brief into a rigged avatar plus posed studio renders; Living Stages covers shareable stages; the Avatar Engines Atlas is the factual survey of the engines in this space and which ones we animate
  • Need to prove what an agent was told to do? → Signed manifests: every persona save signs the agent's full configuration, system prompt included, and pins it to IPFS. Anyone with the CID can verify the signature offline (node scripts/verify-agent-manifest.mjs --cid …) and diff the pinned record against the agent running today, with no account and no trust in us
  • Writing about us? → The press kit has the logos, the usage rules, and the boilerplate (editorial use needs no permission), and the partner ecosystem maps every partner program to what the integration actually is
  • Backing an agent with capital? → USDC agent vaults: NAV-priced deposits and redemptions, the drawdown breaker that halts a vault, performance-fee claims, and the public audit ledger anyone can read
  • Funding your own agents? → Your master wallet: the per-user custodial hub you fund once, then top up agent wallets, send SOL or USDC, and read on-chain history from
  • Following a trader instead of picking? → Copy trading: follow a leader two ways, either your agent mirroring real Solana trades inside its own spend policy, or sized intents you sign yourself. Nothing is simulated, so the doc covers the leaderboard weighting, the Smart Money directory, and how performance fees accrue
  • Found a coin and want to act on it now? → Fork a trade: one tap on any coin across the Radar, the Live Trade Feed, the Smart Money Radar, or a ghost-copy replay opens the real pump.fun trade panel for it, pre-filled with the size being forked and signed by your own wallet. No custody, no delegated key, the same safety firewall as every other trade surface, and a ?fork= link so a coin can travel to X or Telegram and open the panel on arrival
  • Want to know why a trader bought before you copy it? → Trade receipts: press why on any closed trade on a track record to see the evidence the agent had at decision time (the entry trigger, the Oracle score and its base-rate reasons, the on-chain firewall simulation, the LLM judge, the Risk Officer, paid x402 reads with their payment tx) and every leg on Solscan. Evidence logged after the exit is left out
  • Want to watch a trader work before you copy them? → Live trade rooms: step into any public trader's 3D room and see their real buys and sells land as they fill, with the avatar reacting, the receipt for why on every trade, one-tap Fork, and ghost-copy or copy from the same page. A quiet room still shows their latest real trades and which rooms are live right now
  • Never copied a trader and want to start safely? → Copy Coach: a real win shown next to the full record behind it, a ghost copy with fake money, then one tiny copy the server caps and you sign yourself. The coach answers questions from the real numbers on the page and never promises returns
  • Want momentum you can actually check? → Sentiment Scout: the last hour of pump.fun launches ranked by momentum, every claim linked to the post or read it came from, timestamped, and checked against the chain, with a track record graded against real outcomes
  • Not ready to risk money on a trader yet? → Ghost-copy: paper-copy any verified agent over their real closed on-chain trades and see the equity curve your budget would have had, sized by the same engine that runs live copy trades. No wallet, no signature, no account, and every trade your budget could not reach is listed with the reason
  • Want a squad that researches before it trades? → Specialist teams: four 3D agents (a Researcher, an Entry scout, a Trader and a Launcher) under one spend policy, posting to one live findings board. The Trader only acts on research it can cite, reuses verdicts instead of redoing them, and the Launcher prepares plans you sign yourself
  • Want to tell your squad what to do in one sentence? → Squad chat: the coordinator plans role-tagged steps, the specialists run them live with evidence, and anything that signs, moves funds, launches or exceeds your cap waits for your approval, then resumes with receipts
  • Rather copy with a crew? → Syndicates: a named team that follows the same verified traders together, each member from their own wallet under their own caps. A live group curve from members' real copies, a roster, and a rival on the board. Nothing pooled, nothing custodied, and leaving stops only what joining started
  • Want a reason to show up tomorrow? → Daily trading quests: five small goals a day scored from on-chain proof (verified trades, forks, first ghost-copies, acted copy intents, your agent's live wins), with XP, levels, a clear streak and badges
  • Think you can call the winner? → Trader duels: free-to-play calls on which of two neighbouring traders books more realized profit over a UTC day or week, resolved from the on-chain ledger. Daily free points (no cash value), XP, a monthly season board and badges
  • Have an audience of your own? → The trader card: one script tag puts a trader's live on-chain record on your site, blog, link in bio or stream overlay, with a Fork button on every coin and a ghost-copy call to action, all signed by the reader's own wallet. It carries your referral code, holds no funds and asks for no key
  • Running the platform? → Trading growth programs: the big-win X poster, the first-rug softener and the early-leader $THREE bonus. All three ship disarmed; the page shows how to read what each would do today, every flag and cap, and the exact steps to arm one
  • Running a chart page, a launchpad or a wallet? → Token in 3D, as an embed: one iframe puts a live 3D view of any Solana market on your page, keyed by the mint or by the pair address your own URL already carries, with the coin's logo on a medallion, its holders as a galaxy sized by balance, a graduation ring and real swaps arriving on a tape. Free, keyless, no account, and it degrades to a data view where WebGL is unavailable
  • Streaming charts, or want company on one? → Chart Companion: paste any DEXTools pair and a 3D agent watches the live chart with you, reacting to every real swap with a move and a line you can trace to its transaction. Embed it with one iframe, or add it to OBS as a transparent overlay
  • Want your community on your DEXTools page? → DEXTools integration: paste any DEXTools pair link at /dextools and get a 3D scene or a Social Boost card to embed on your own site, and see the visits three.ws sends to DEXTools pair pages, counted in the open
  • Want to know what just changed on the board? → Rivalries: every trader on the arena leaderboard is paired with the one directly above them and labelled an overtake, a debut or a standing chase, with the profit both sides settled in the last 24 hours as the reason. Worked out by rebuilding what the board said at the cutoff from the trade timestamps, so it reaches back over history already recorded and never disagrees with the leaderboard
  • Watching identities land on-chain? → On-chain deployments: the live feed of agent identities registering on-chain as it happens, Solana Metaplex Core mints alongside ERC-8004 registrations across 15 EVM chains, with chain footprint and capability stats
  • Building against the API? → The developer platform: API keys, usage metrics, signed webhooks, the one-call MCP connection test, and the public tool and skills catalogs, with a runnable example per endpoint
  • Auditing an agent's decisions? → The Reasoning Ledger: hash-chained, on-chain-anchored records of every consequential agent decision, verifiable by anyone at /ledger
  • Following Solana traders? → KOL Tracker: KOLs ranked by realized P&L computed from their own wallets' on-chain trades (never self-reported), with the public API behind it
  • Listening to the economy? → Agent Symphony: /symphony plays the live agent economy as generative music; every event type has a voice, and solo mode isolates one agent by ear
  • Catching up on your inbox? → Notifications: the bell, the /notifications center, category filters, and the full inbox API
  • An agent waiting on your yes? → Approvals: the /approvals inbox, push Approve/Deny, signed deep links, payload-hash checks, and auto-approve rules
  • Talking to your agent from Telegram or Discord? → Chat gateways: pairing, commands, what can be approved from chat, privacy
  • Linking a phone, CLI, Telegram or wallet to your account? → Account linking: Telegram sign-in, one-time link codes, external wallets with step-up and cooldown
  • Keeping an agent inside a budget? → Usage control and spend: dollar caps and hourly, daily and per-run token ceilings per agent, the /spend page with usage by day, model and tool and the projected month end, alerts at 50, 80 and 100 percent, resume and extend-once, top-ups in SOL, USDC and $THREE, and the free-tier error that carries your choices
  • Want your agent to have an email address? → Agent Mail: a real inbox on agents.three.ws, quote-then-confirm sends, a recipient allowlist and daily cap, received mail treated as data, and rules that turn incoming mail into agent runs
  • Want your agent to bill someone, sell something or buy from another agent? → Agent Commerce: invoices in USDC, SOL or $THREE paid by Solana Pay link or QR and verified on-chain, quote-then-confirm sends and purchases, offers with fulfillment, and limit changes an agent can propose but only you can approve
  • Something too important for a badge? → Herald: the open SDK behind /herald, where a 3D character walks onto the page and says it out loud, with an interrupt budget (importance floor, quiet hours, dedupe, batching), an accessible card for machines with no GPU, a rail so CI or an AI agent can reach the tab you have open, and a CLI that announces when your build finishes
  • Want strangers to be able to reach you, but not for free? → Knock: a priced door at /knock/ that anyone, human or agent, can pay to get one message through; the USDC settles straight to your wallet, your companion delivers it in person, and every refusal happens before the payment
  • About to pay for something? → Checkout companion: the browser extension that reads a payment page before you pay, why the arithmetic is never a model's job, and why it never reads a form field
  • Curious what a website looks like as a place? → Portal: paste any address and walk it in 3D; sections become buildings sized by what they say, links become doors you step through, and the world downloads as a GLB, embeds in your page, or reaches an agent over MCP
  • Did that re-export break the rig? → Model Diff: what actually changed between two GLBs, why a rename is not a rewrite, and the severity that tells you a dropped joint from a recolour
  • Something broken on a page? → Feedback: telling the corner companion what went wrong, what the browser attaches for you, and the boundary that keeps untrusted text from ever reaching anything with write access
  • Showing off your work? → The creator portfolio: everything on your public /u/username page, what makes an item public, and how following works from it
  • Exploring our history? → The Story So Far: three.ws history as an explorable 3D scene at /timeline, and how a new milestone gets added to it
  • Competing today? → Daily Match: live daily standings over real agent output (actions, trades, skill sales, launches), resetting 00:00 UTC
  • Developer docs → Read the Introduction for the full technical picture
  • Contributing code? → Shared utilities — the modules to import instead of hand-rolling: sanitized Markdown, toasts, fuzzy search, retry/circuit-breaking, bounded caches and concurrency pools, and safe CSV export
  • Wondering what happens when a third-party service goes down? → Upstream resilience map: every external service this platform calls, what protects each call, and the degradation contract each endpoint is held to
  • Your agent needs a face? → OKX.AI marketplace services — the Agent Identity Studio and the pay-per-call 3D services other agents buy from us; demo identities at /agent-identities
  • Buying 3D asset work per call? → The 3D Asset Pipeline — pay a few cents in USDC to rig, remesh, make game-ready, stylize, or background-remove an asset; one call, one finished URL, no account or API key
  • Want your agent to have a body? → Embodiment — one $1 USDC call turns a prompt or image into a rigged, animated, voiced 3D avatar plus a one-tag embed for any website; no account, no separate rigging step
  • Building UI? → ui-juice is the shared game-feel library (count-ups, sparklines, ring gauges, live dots, the "it shipped" ripple) every surface animates with
  • Teaching another AI to use three.ws? → The Agent Skills pack — portable SKILL.md folders that give any Claude surface (Claude Code, the Claude apps, the Agent SDK) three.ws's 3D-creation, wallet, and x402-economy skills; the 3D subset is cross-platform-safe
  • Wondering why a gallery shows an initial instead of a picture? → Avatar thumbnails — where an avatar's preview image comes from, the one rule every code path obeys (never publish a thumbnail URL whose object doesn't exist), the two crons that keep coverage at 100%, and how to run the backfill
  • Adding 3D to a page, or wondering why one feels slow? → Page performance: the rules a three.ws page plays by, a model preview runs only while someone is looking at it, a model loads when it is wanted, anything that arrives late reserves its box first, and images are fetched at the size they are shown
  • Running your voice agent on LiveKit or Pipecat? → LiveKit and Pipecat avatar integrations: drop livekit-plugins-threews or pipecat-threews into your pipeline and a real <agent-3d> avatar lipsyncs and gestures to it, no server-side rendering, no cloud account required to try it against a local livekit-server

Reference shelf

Deeper references that don't fit a track above but answer real questions:

  • Event Markets: the free-to-play "who wins this event?" layer, how picks, points budgets and crowd odds work, the REST and MCP surface, and how markets open, lock and resolve
  • Atomic Solana V1 inspector: inspect a confirmed mainnet signature or raw signed transaction, measure its exact 1,232-byte or 4,096-byte envelope, and verify the execution limits a fee sponsor is being asked to accept
  • Global Intel Globe: the live 3D globe at /globe, its eleven keyless open-data layers, the one call that returns them all, and why a cron keeps its own GDELT window
  • The ship log: how every release note is joined to the commits that shipped it, the public feed at /api/ship/feed (JSON, Markdown, RSS, and a per-commit "why did you link that" endpoint), and the zero-dependency package that does it for any repository
  • Docs World: these same docs as a walkable 3D world, where every section is a pavilion you can stroll up to and read inside the scene
  • Agent Monitor: the ops room at /monitor, twelve live panels covering fleet activity, money, revenue, creations and uptime, plus how to add a panel
  • Agent Spotlight: the community showcase at /spotlight, what an entry stores versus what it reads live off the agent, the trending decay formula, and the full showcase API
  • How three.ws is served to search engines: the four server-side render paths behind a JavaScript site, the two contracts that keep a page and its sitemap entry agreeing, and how to audit the live origin
  • Design tokens: the canonical design vocabulary (colors, spacing, type, motion) every surface builds from
  • NVIDIA models on three.ws: the free hosted inference layer model by model, one key behind text-to-3D, chat, vision, embeddings, safety, and speech
  • Run an inference node: join the supply side of the open inference network with your own hardware, from clone to a signed, verified result, on CPU or an NVIDIA GPU
  • three.ws on Solana Seeker: the Android app for Seeker and Saga, and what it adds on top of the website (Seed Vault sign-in, share-sheet capture, offline shell, Seeker verification)
  • Publishing to the Solana dApp Store: the release runbook for the Seeker app, from the Publisher Portal setup and the release keystore through building, verifying, and submitting a signed APK
  • Submission day: getting three.ws onto the Seeker dApp Store: the owner's step-by-step, with every portal field, the listing copy to paste, and the five screenshots to capture on the phone
  • Filming three.ws on a Seeker without a Seeker: how to record a Seeker screen-recording of the app with no device, why the TWA makes that a real capture rather than a mock-up, and what still has to come from an emulator
  • Filming the product demo: the narrated walkthrough of every feature on the live site, how the route is generated from the Feature Tour curriculum so a new page films itself, and how to re-shoot a single chapter
  • three.ws on iOS: the App Store app, what it adds on top of the website (native share sheet, universal links, wallet deep links, offline shell), and how the web half of it ships on every deploy
  • Free LLM providers: the failover chain of a dozen free AI providers behind every text completion, what each free tier gives, and how to add the next rung
  • Fresh-wallet workers: how the platform mints a brand-new Solana wallet for every x402 purchase, what those wallets buy (3D props for the library, datasets for the data desk), why nothing strands, and where to watch it
  • Tokens API on three.ws: the Solana Foundation asset layer that tells us which mints are the same asset, why it sits second in the market-data cascade, and the one env var that turns it on
  • NVIDIA Inception membership: what the platform already runs on NVIDIA silicon and what the program adds on top
  • NVIDIA visibility map: every NVIDIA surface worth being on (Showcase, GTC, NGC, ACE, the forums, social), the verified intake route for each, and the member benefits nobody has claimed yet
  • Big-tech recognition dispatch board: every big-tech surface ranked against every other by the odds of a published mention this week, which six are already one action from shipping, and what to stop chasing
  • Partner prospects: the scored list of companies and open-source projects worth partnering with (2026-10-09 sweep), with the intake route for each, worked by the outreach plan; the Tripo brief is the first deal on it
  • Partnership and listing pipeline: every partnership, marketplace and directory as one decision list, showing what is stuck, on whom, and the single step that unblocks it
  • IBM visibility map: every IBM surface worth being on (the user group, IBM Champions, the Partner Plus Directory, the IBM Cloud catalog, TechXchange), the verified intake route for each, and the two windows that close on a date
  • IBM Partner Plus: the companion audit of the program itself, including the watsonx Orchestrate Agent Catalog listing through Agent Connect
  • The generator was never the hard part: our Nemotron Nano write-up, published on the NVIDIA Developer Forums
  • three.ws on the AWS Builder Center: the index of our published AWS engineering writing, what code each article documents, and the checklist for publishing the next one
  • Mobile launch articles: the five long-form pieces announcing the Seeker, Android, and iPhone apps, one per venue (X, CoinMarketCap, AWS Builder Center, NVIDIA Developer Forums, IBM Community)
  • three.ws on Hugging Face: our organization account there, the community article on giving agents bodies and wallets, the published avatar rigs and the Space that renders them, and the checklist for publishing the next one
  • The onboarding tier: why a first-time visitor sees ~20 nav destinations instead of ~100, how the Simple ⇄ Everything switch works, and which tier a new page belongs in
  • What an agent can do: the full abilities dossier, generated from the source article
  • Use cases and example workflows: five audience-specific walkthroughs tying shipped features to concrete outcomes
  • UX Flow Atlas: screen-by-screen traces of the platform's core flows, starting with onboarding and creation
  • Demo routes: the canonical map of every /demo/* and /demos/* route
  • Doc freshness: how every doc is bound to the code it names, how drift is measured and ranked at /docs/freshness, and how to record that you checked a page
  • Agent trading spec: the proposed agent trading capability contract
  • ERC-8004 validation attestation: the attestation written when an agent registers on-chain
  • zauth: the vendored security infrastructure docs our agent auth builds on
  • The /launch launchpad: launch a pump.fun coin for a 3D agent from your wallet or the agent's wallet, pay a disclosed 1% dev-buy fee, and claim creator rewards on three.ws, with automatic Solana transaction v1 for launches that overflow v0
  • Agent tokens: configure the coin an agent will become, rehearse the launch for free against a real cluster, then launch it on Solana
  • pump.fun program docs: the vendored on-chain program reference behind the launch surfaces
  • pump-fun-mcp at the edge: the Cloudflare Workers mirror of the pump.fun MCP endpoint
  • Package extraction: how reusable packages graduate out of the monorepo
  • Agent task briefs: self-contained task prompts for AI agents working on the platform
  • Troubleshooting and FAQ: fixes organized by symptom
  • The 3D viewer: the rendering layer reference (model loading, cameras, animation, lighting)
  • Avatar Artifact: the standalone viewer page, its ?agent= and ?model= parameters, and the iframe you paste anywhere
  • Farcaster memory seeding: give an agent your Farcaster voice, proved with a wallet the account already verified, and revoke it in one click
  • The announcement factory: how the 322 shipped surfaces that have never been posted about get a dated slot, an evidence brief, a frame, a drafted post, and a pack, one command per batch
  • X content pipeline: how @trythreews publishes native video, images, threads, blog shares, and full X Articles from one reviewed queue on a human cadence
  • Writing a story for the X queue: how to write a post whose video is a filmed, passing run of the feature it announces
  • X memory seeding: seed an agent from your public X posts behind an explicit, versioned consent you can revoke (revocation deletes what the seed wrote)
  • GitHub memory seeding: tick the profile, repositories, and READMEs your agent may read, and nothing outside that list is ever fetched or stored (disconnecting deletes every fact it wrote)
  • Memory seed connectors: the public read-only lane behind the seeding demo. Turn a GitHub, X, or Farcaster handle into a footprint payload, then synthesize a memory seed from any subset of them
  • The catalog quality gate: how a platform-seeded model earns its slot in the public catalog, the two stages it must pass, and why a rejected asset is kept rather than deleted
  • Likeness evaluation: the Phase 1 verification metric, measured rather than asserted. Every reconstruction is rendered at three yaws and compared to the photos it was built from with an open-source face-recognition embedding, so "4 out of 5" means one fixed, calibrated thing
  • Examples gallery: copy-paste-ready code for common use cases
  • Cookbook: recipes you download and run, each one a real file executed against the live API, with the prose explaining why it is shaped that way
  • Premium: the monthly Data API pass, one on-chain payment replacing per-call micropayments for 30 days
  • Guardian console: the inbox for the other side of social recovery and inheritance of agent wallets
  • Coin Clash: token-gated community battles between coin factions
  • Daily Forge: a new deterministic 3D creative challenge every day
  • CAD Forge: a sentence becomes a kernel-checked parametric part with STEP, STL, GLB, drawings and dimension sliders
  • x402 Studio: the merchant console for running a paid x402 business on three.ws
  • Contributing: local environment setup through a mergeable pull request
  • ERC-8004 smart contracts: contract interfaces, deployed addresses, and how to read and write each registry
  • Internationalization: how the UI translation catalog works and how to add a locale