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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs(structure): add the Agent Galaxy row and refresh the studio doc image
nirholasff3144f78f3c
diff --git a/STRUCTURE.md b/STRUCTURE.mdindex 20f62ac59..d24fb321d 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -59,6 +59,7 @@ bottom.| Daily Match (agent output arena) | [pages/daily-match.html](pages/daily-match.html) `→ /daily-match`, backend [api/leaderboard/daily-match.js](api/leaderboard/daily-match.js) | Live | Live daily standings ranking public agents by real output shipped since 00:00 UTC: agent_actions events, sniper + pump trades, confirmed skill sales, and coin launches, with realized sniper P&L shown for context (never scored). Computed live per request (no rollup cron), resets naturally at UTC midnight; includes yesterday's champion and a live-output feed. Reputation-first: no payouts hang off the score. Format adopted with credit from Bowyer's Arena (bowyer.app/arena), who build their agent pages on three.ws avatars. || KOL Tracker | [pages/tracker.html](pages/tracker.html) `→ /tracker`, backend [api/kol/[action].js](api/kol/%5Baction%5D.js) `→ GET /api/kol/tracker?window=&limit=`, aggregator [src/kol/tracker.js](src/kol/tracker.js), wallet list [src/kol/wallet-store.js](src/kol/wallet-store.js) (bundled [src/kol/wallets.json](src/kol/wallets.json) + admin R2 imports via `POST /api/kol/import-gmgn`), FIFO P&L engine [src/kol/wallet-pnl.js](src/kol/wallet-pnl.js), cached X follower/avatar lookup [src/kol/x-profile.js](src/kol/x-profile.js) | Live | Solana crypto KOLs ranked by realized P&L computed from each tracked wallet's own on-chain trade history (24h/7d/30d), with win rate, volume, and trade count — every number traceable to real trades, never a competitor's computed leaderboard. A wallet only shows an X handle/avatar/follower-count when an admin has explicitly attached a verified `xHandle` via `import-gmgn`'s `xHandles` map (never inferred or scraped); unattached wallets rank by wallet address alone. Rows with no configured trade source (`PUMPFUN_BOT_URL`) fall back to an imported `pnlUsd`/`winRate` labeled with its `pnlSource` rather than fabricating on-chain numbers. Prewarm cron: [api/cron/kol-tracker-refresh.js](api/cron/kol-tracker-refresh.js). || Agent Galaxy (every agent as a star, positioned by meaning) | [pages/galaxy.html](pages/galaxy.html) `→ /galaxy` + [src/galaxy.js](src/galaxy.js), backend [api/galaxy.js](api/galaxy.js) `→ GET/POST /api/galaxy`, assembler [api/_lib/galaxy.js](api/_lib/galaxy.js), embedding cache [api/_lib/agent-embeddings.js](api/_lib/agent-embeddings.js), live-economy overlay over `GET /api/galaxy/flows` | In-repo · awaits watsonx credentials | Every published agent embedded with an IBM Granite model on watsonx.ai, projected to 3D by PCA and grouped into k-means constellations that Granite then names, rendered as a Three.js point cloud. Typing a phrase embeds the query in the same space and lights the matching stars; the Money-Cam layer animates real on-chain transfers between them, and star brightness comes from each agent’s real wallet net worth. No mock path anywhere: with no watsonx credentials on the service `GET /api/galaxy` answers 503 and the page says so, offering the agent list and the integration doc instead of an empty universe. Tests: [tests/e2e/galaxy.spec.js](tests/e2e/galaxy.spec.js), [tests/galaxy-flows.test.js](tests/galaxy-flows.test.js) |+| The Agent Economy (live, network wide) | [pages/economy.html](pages/economy.html) `→ /economy` + page module [src/economy-live.js](src/economy-live.js), hire panel [src/shared/agent-hire.js](src/shared/agent-hire.js), feeds `GET /api/agents/economy?view=offers` ([api/agents/economy.js](api/agents/economy.js)), `GET /api/marketplace/agents`, `GET /api/agenc/x402-services` ([api/agenc/[action].js](api/agenc/%5Baction%5D.js)) over the shared discovery client [api/_lib/x402/bazaar-client.js](api/_lib/x402/bazaar-client.js) | Live | The wide-angle counterpart to the curated two-agent demo at `/agent-economy`: the real population of agents earning on three.ws, the agent-to-agent service market they hire each other through, and the live x402 bazaar of pay-per-call endpoints across Solana and Base. Three feeds, each owning its own loading / empty / error state so a slow or failing one never blanks the page, each retryable in place, and each polled every 45s while the tab is visible. Service rows name themselves from the facilitator's `metadata` when it publishes one and from the endpoint URL when it does not (most listings carry no name), show the endpoint they charge for, and never render a link to a path template or a rejected URL scheme. The A2A offers feed is empty until an owner prices an agent skill (`agent_paid_services`), which is a real state with a route out of it, not a stub. Tests: [tests/api/bazaar-endpoints.test.js](tests/api/bazaar-endpoints.test.js) || Agent Symphony (economy as generative music) | [pages/symphony.html](pages/symphony.html) `→ /symphony`, engine [src/symphony.js](src/symphony.js), grammar [src/symphony-score.js](src/symphony-score.js) | Live | The live activity bus (`GET /api/feed` + `/api/feed-stream` SSE) rendered as WebAudio generative music: one synthesized note per real platform event, voice by event type (payments pluck, coin buys land as bass, new agents chime, guard refusals play dissonance, jackpots glissando), pitch register by amount (whales sit lower), stable per-actor motif + stereo position via FNV-1a hash, all quantized to one pentatonic scale so arbitrary event streams harmonize. Canvas visualization, live ledger with real click-throughs, and a MediaRecorder tap that exports a shareable audio clip of the master bus. A burst gate collapses event floods (a sniper sweep emitting dozens of identical guard events) into one accented note per actor per 1.5s. Solo mode narrows the stream to one participant client-side (`?agent=<id>` exact, `?actor=<label>` case-insensitive), reachable from the per-row "solo" control and from the "Listen →" link on every agent profile's Wallet Story card. No audio assets, no synthetic events. Tests: [tests/symphony-score.test.js](tests/symphony-score.test.js) || Platform activity feed | [pages/feed.html](pages/feed.html) `→ /feed` + [pages/community.html](pages/community.html) `→ /community`, backend [api/users/me/feed.js](api/users/me/feed.js) | Live | Reverse-chronological creation events (avatars, agents, coins, models, worlds) plus follow activity, merged at read time from `forge_creations`, `dioramas`, and `user_follows` (no separate event log to drift out of sync). `?scope=following` (default; session-gated, anonymous gets 401) vs `?scope=all` (public; powers `/community` and first-visit feeds); `limit` 1..50, `before` ISO cursor. Items deep-link to creator portfolios. Distinct from the Money Pulse ticker `GET /api/feed` ([docs/money-feed.md](docs/money-feed.md)). Docs: [docs/social-layer.md](docs/social-layer.md) || Follow graph | [api/users/[username]/follow.js](api/users/%5Busername%5D/follow.js) + [api/users/[username]/follows.js](api/users/%5Busername%5D/follows.js), table `user_follows`, buttons on [pages/profile.html](pages/profile.html) | Live | `GET` returns `{following, followed_by, followers_count, following_count}`; `POST`/`DELETE` are idempotent (session + CSRF, self-follow 400) and return the same envelope so one round-trip updates the button and the counts. A genuinely new edge (`ON CONFLICT DO NOTHING`) publishes a `follow` user event to the notification bell exactly once. Feeds the activity feed's following scope, search ranking, and the `followers` leaderboard metric. Tests: [tests/api/users-follow.test.js](tests/api/users-follow.test.js). Docs: [docs/social-layer.md](docs/social-layer.md) |diff --git a/src/dashboard-next/pages/home.js b/src/dashboard-next/pages/home.jsindex 6ccbe1a3a..c112e4691 100644--- a/src/dashboard-next/pages/home.js+++ b/src/dashboard-next/pages/home.js@@ -759,7 +759,7 @@ function renderForgeAnnounce(host) {<div class="dnx-forge-head"><span class="dnx-forge-badge">New</span><span class="dnx-forge-title">Text & image to 3D are live</span>- <span class="dnx-forge-sub">Describe any object, or upload a photo of one — get a downloadable, textured GLB in seconds.</span>+ <span class="dnx-forge-sub">Describe any object, or upload a photo of one, and get a downloadable, textured GLB in seconds.</span></div><form class="dnx-forge-form" novalidate><label class="dnx-forge-field">@@ -946,7 +946,7 @@ function renderOnboarding(host, { avatars, agents, widgets, loadErrors = {} }) {icon: OB_ICONS.avatar,label: 'Create your first avatar',outcome: 'Your selfie becomes a 3D character ready to talk to visitors',- detail: 'We turn a single photo into a full-body animated 3D agent in under 60 seconds. No design tools, no uploads — just a selfie.',+ detail: 'We turn a single photo into a full-body animated 3D agent in under 60 seconds. No design tools, no uploads, just a selfie.',href: avatars.length === 0 ? '/start' : '/create',cta: avatars.length === 0 ? 'Take a selfie' : 'Create another avatar',done: avatars.length > 0,@@ -955,7 +955,7 @@ function renderOnboarding(host, { avatars, agents, widgets, loadErrors = {} }) {id: 'agent',icon: OB_ICONS.agent,label: 'Give your avatar a brain',- outcome: 'It learns your personality and answers in your style — not a generic bot',+ outcome: 'It learns your personality and answers in your style, not a generic bot',detail: 'Set its name, persona, and knowledge base. Upload docs, link URLs, or just write a prompt. This is what makes it distinctly yours.',href: agents.length === 0 ? '/start' : '/dashboard/agents',cta: 'Set up agent',@@ -965,8 +965,8 @@ function renderOnboarding(host, { avatars, agents, widgets, loadErrors = {} }) {id: 'widget',icon: OB_ICONS.widget,label: 'Put it on your website',- outcome: 'One line of HTML — visitors chat with your 3D agent in 2 minutes',- detail: 'Copy a single script tag. Drop it anywhere — WordPress, Shopify, Webflow, raw HTML. Visitors see your agent immediately, no account required on their end.',+ outcome: 'One line of HTML, and visitors chat with your 3D agent in 2 minutes',+ detail: 'Copy a single script tag. Drop it anywhere: WordPress, Shopify, Webflow, raw HTML. Visitors see your agent immediately, no account required on their end.',href: '/dashboard/widgets',cta: 'Create embed widget',done: widgets.length > 0,@@ -975,13 +975,13 @@ function renderOnboarding(host, { avatars, agents, widgets, loadErrors = {} }) {id: 'monetize',icon: OB_ICONS.monetize,label: 'Start earning from chats',- outcome: 'Charge per message, set a subscription, or let fans tip — you keep 90%',+ outcome: 'Charge per message, set a subscription, or let fans tip. You keep 90%',detail: 'Your agent becomes a revenue stream. Choose your pricing: per-message, monthly subscription, or tip jar. Payouts in USDC, directly to your wallet.',href: '/dashboard/monetize',cta: 'Set up monetization',done: guideStepDone('monetize'),optional: true,- optionalTip: 'Earning and payouts settle in USDC and need a wallet. It is entirely opt-in — your agent works exactly the same without it.',+ optionalTip: 'Earning and payouts settle in USDC and need a wallet. It is entirely opt-in, and your agent works exactly the same without it.',},];@@ -998,7 +998,7 @@ function renderOnboarding(host, { avatars, agents, widgets, loadErrors = {} }) {const doneStepsHtml = steps.filter((s) => s.done).map((s) => `- <li class="dnx-ob-done-row" aria-label="${esc(s.label)} — complete">+ <li class="dnx-ob-done-row" aria-label="${esc(s.label)}, complete"><span class="dnx-ob-done-check" aria-hidden="true"><svg viewBox="0 0 14 14" width="11" height="11" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="M2 7l3.5 3.5L12 3"/></svg></span>@@ -1216,7 +1216,7 @@ const DIRECTORY = [{group: 'Create & Build',items: [- { href: '/create', title: 'Create Avatar', sub: 'Snap a selfie — 3D agent in 60 seconds' },+ { href: '/create', title: 'Create Avatar', sub: 'Snap a selfie, 3D agent in 60 seconds' },{ href: '/create/selfie', title: 'Selfie Capture', sub: 'Camera-based avatar creation flow' },{ href: '/avatar-studio', title: 'Avatar Studio', sub: 'Full 3D editor with lighting and poses' },{ href: '/brain', title: 'Brain', sub: 'Persona builder, model playground, agent voice' },@@ -1402,7 +1402,7 @@ function renderDirectory(host) {<button class="dnx-dir-head-toggle" aria-expanded="${!collapsed}" data-action="dir-toggle"><div><div class="dn-panel-title" style="margin:0 0 2px">All Features & Pages</div>- <div class="dn-panel-sub" style="margin:0">Every tool, page, and feature on three.ws — all in one place.</div>+ <div class="dn-panel-sub" style="margin:0">Every tool, page, and feature on three.ws, all in one place.</div></div><span class="dnx-dir-chevron" aria-hidden="true"><svg viewBox="0 0 12 12" width="12" height="12" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M3 4.5l3 3 3-3"/></svg>