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(marketing): count the footprint beyond this repo for the 100-stars announcement
nirholase844d7395304
diff --git a/docs/media/github-100-stars-ecosystem.png b/docs/media/github-100-stars-ecosystem.pngnew file mode 100644index 000000000..4fe9daf4dBinary files /dev/null and b/docs/media/github-100-stars-ecosystem.png differdiff --git a/docs/weekly-report-1.md b/docs/weekly-report-1.mdindex 2de456fcf..a0bbe47b7 100644--- a/docs/weekly-report-1.md+++ b/docs/weekly-report-1.md@@ -1,6 +1,6 @@# three.ws Weekly Report #1: Everything We Have Shipped So Far-Nineteen weeks. 9,495 commits. 2,674 changelog entries. 724 pages. 70 npm packages. 72 MCP servers in the official registry. One token.+Nineteen weeks. 9,508 commits. 21 contributors. 2,674 changelog entries. 725 pages. 101 npm packages. 72 MCP servers in the official registry. 4,519 x402 endpoints. One token.This is the first weekly report, and because it is the first, it is also the whole story. It runs from the first commit on April 14, 2026 to today, August 25, 2026, week by week, and it covers everything: what we built, what we announced, what we partnered on, and where $THREE fits. Every number in it comes from the public repository, the public changelog, or a public listing.@@ -14,10 +14,12 @@ If you only read one line: three.ws went from an empty repo to a live, open-sourBefore the timeline, the totals as of August 25, 2026:-- 9,495 commits on main since April 14. To be honest about the count: roughly 2,200 of those in one May week were per-file imports of two vendored workspaces, and about 250 were deliberate empty commits in another. Strip those and it is still north of 7,000 real changes in 19 weeks, about 50 a day, every day.+- 9,508 commits on main since April 14 from 21 contributors, 60 pull requests, 104 stars, 26 forks. To be honest about the count: roughly 2,200 of those in one May week were per-file imports of two vendored workspaces, and about 250 were deliberate empty commits in another. Strip those and it is still north of 7,000 real changes in 19 weeks, about 50 a day, every day.- 2,674 holder-readable changelog entries: 991 features, 1,075 improvements, 1,190 fixes, 320 infrastructure, 226 docs, 216 security, 166 SDK. Every one is pushed to the holders' Telegram automatically.- 724 public pages across Build, Discover, Learn, Crypto, Labs, Blog, and Legal.-- 70 packages under packages/, 53 npm workspaces, 72 distinct servers under one namespace in the official MCP registry.+- 101 npm packages published under the @three-ws scope (42 of them MCP servers, 6,225 downloads in the last 30 days), 72 distinct servers under one namespace in the official MCP registry, 60 installable agent skills.+- 4,519 priced x402 endpoints in the live discovery catalog, 110,416 on-chain settlements and 803,483 payment verifications through our own self-hosted facilitator, 3,000 validator attestations and 126,522 custody proofs on Solana.+- 111 open-source repos spun out of three.ws with 1,222 stars between them, ERC-8004 registries live on 12 EVM mainnets, two Solana programs, 33 workers, 1,752 test files. All Apache-2.0.- 40 blog posts, 47 product announcements on X, and 21 more announcement drafts waiting in the queue.- A crypto news archive of 740,889 articles from 197 publishers going back to September 2017, updated hourly.- Over 1,000,000 individually priced x402 datapoints at $0.0005 each.@@ -562,6 +564,22 @@ Pages include /deploy-onchain, /ar/view, and docs for play vehicles, community,---+## The open-source footprint, all in one place++Everything three.ws ships is Apache-2.0, and it has not stayed inside one repository. Where it stems:++- The main repo, github.com/nirholas/three.ws: 9,508 commits, 21 contributors, 60 pull requests, 104 stars, 26 forks, 70 packages, 33 workers (27 as Docker images), 31 specs, 323 docs, 1,752 test files, 4 Rust crates, 7 Solidity contracts, 2 Anchor programs.+- npm: 101 packages under @three-ws, 42 of them MCP servers, 6,225 downloads in the last 30 days. Avatars, x402 payments, Solana agents, pump.fun tooling, voice, mocap, retargeting, sign language, the assistant and concierge widgets, readme-3d, 3d-ar-studio.+- The official MCP registry: 72 servers under io.github.nirholas. Also listed on Smithery, Glama, and PulseMCP, and on x402scan.+- 111 related public repos with 1,222 stars between them: a 50-repo x402 suite of standalone paid services, the Robinhood Chain family, the extracted x402 server, fetch, modal, bridge, and VS Code extension, the Metaplex agent MCP, on-chain agent wallets, the AR Studio, the news archive, the X Spaces voice agent, and more.+- On-chain: ERC-8004 identity, reputation, and validation registries deployed by CREATE2 to the same address on 12 EVM mainnets (Ethereum, Optimism, BSC, Gnosis, Polygon, Mantle, Base, Arbitrum, Celo, Avalanche, Linea, Scroll), bytecode-verified; the ThreeWSFactory and payments contracts; two Solana programs for agent invocation and skill licensing.+- x402: 4,519 priced endpoints in the live discovery catalog, 110,416 on-chain settlements and 803,483 verifications through the self-hosted facilitator, 3,000 validator attestations under the threews.validation.v1 memo envelope, 126,522 custody proofs across 244 epochs.+- Hugging Face: the three-ws org, the avatar-viewer Space, the avatars model repo, and a published blog post, "Giving AI agents bodies and wallets."+- Editors and stores: a Blender addon, ComfyUI nodes, the VS Code x402 extension on the VS Code Marketplace and Open VSX, a Chrome extension, and two Claude Code plugins in the plugin marketplace.+- Three GitHub Pages apps that run with no server and no account: the AR Studio, the Metaplex agent deployer, and the on-chain agent wallets overview.+- Open assets: 500+ CC0 3D props, 106 rigged characters, 3,000+ animations, and a free crypto news API over a 740,889-article archive.+- Agent skills: 60 SKILL.md skills any agent can install.+## The partnerships, all in one placeBecause they are spread across nineteen weeks, here is the full list:diff --git a/docs/x-posts/github-100-stars.md b/docs/x-posts/github-100-stars.mdindex 7d4181c80..409d44b3c 100644--- a/docs/x-posts/github-100-stars.md+++ b/docs/x-posts/github-100-stars.md@@ -1,8 +1,8 @@# X posts: 100 stars on GitHub-Post copy for the 100-star milestone on X. Posting is owner-gated; these are ready-to-paste drafts. Attach [media/github-100-stars-x.png](../media/github-100-stars-x.png) (2400x1350, black background, three.ws lockup, twelve stat tiles) to the main post. [media/github-100-stars-square.png](../media/github-100-stars-square.png) (1620x1620) is the square cut for Telegram, Instagram, and LinkedIn.+Post copy for the 100-star milestone on X. Posting is owner-gated; these are ready-to-paste drafts. Attach [media/github-100-stars-x.png](../media/github-100-stars-x.png) (2400x1350, black background, three.ws lockup, twelve stat tiles) to the main post, and [media/github-100-stars-ecosystem.png](../media/github-100-stars-ecosystem.png) (same size, the footprint beyond the repo) to reply 3. [media/github-100-stars-square.png](../media/github-100-stars-square.png) (1620x1620) is the square cut for Telegram, Instagram, and LinkedIn.-Regenerate both images with `node scripts/render-github-stars-banner.mjs` after updating the `STATS` array in the script.+Regenerate both images with `node scripts/render-github-stars-banner.mjs` after updating the `STATS` and `SURFACES` arrays in the script. The canonical link and number table both announcements (the post and the X article) must cite is [open-source-footprint.md](../open-source-footprint.md); keep the copy below in sync with it.## Where every number comes from (as of August 25, 2026)@@ -21,7 +21,13 @@ Regenerate both images with `node scripts/render-github-stars-banner.mjs` after| 3,000 validator attestations | `solana_attestations` (SPL Memo envelope `threews.validation.v1`, see `specs/VALIDATORS.md`) || 126,522 custody proofs across 244 epochs | `custody_attestation_leaves` / `custody_attestation_epochs` || 725 public pages | `data/pages.json` |-| 70 packages, 33 workers, 31 specs, 1,749 test files, 4 Rust crates, 7 Solidity contracts | the repo tree, all Apache-2.0 |+| 70 packages, 33 workers (27 Docker images), 31 specs, 1,752 test files, 323 docs, 4 Rust crates, 7 Solidity contracts, 2 Anchor programs | the repo tree, all Apache-2.0 |+| 111 related public repos, 1,222 stars between them (192 non-fork repos and 9,298 stars across the whole `nirholas` account) | `gh repo list nirholas`, filtered to repos spun out of or built for three.ws (x402 suite, Robinhood Chain family, MCP servers, SDKs, AR Studio, wallets, news archive) |+| ERC-8004 registries live on 12 mainnet chains | `contracts/DEPLOYMENTS.md`, bytecode-verified 2026-06-19 (Ethereum, Optimism, BSC, Gnosis, Polygon, Mantle, Base, Arbitrum, Celo, Avalanche, Linea, Scroll) |+| Hugging Face org, Space, model repo, blog post | `huggingface.co/three-ws`, `spaces/three-ws/avatar-viewer`, `three-ws/avatars`, `blog/three-ws/giving-ai-agents-bodies-and-wallets` |+| MCP directories: official registry, Smithery, Glama, PulseMCP; x402scan | `docs/listings.md` |+| Blender addon, ComfyUI nodes, VS Code and Open VSX extension, Chrome extension, 2 Claude Code plugins | `integrations/blender`, `integrations/comfyui`, `packages/vscode-x402`, `extensions/`, `marketplace/plugins` |+| 3 GitHub Pages apps | `nirholas.github.io/3D-AR-Studio`, `/metaplex-agent-mcp`, `/onchain-agent-wallets` |## Main post (@trythreews)@@ -69,7 +75,23 @@ The x402 side of the repo is not a demo:Every line of that stack is public. Fork it and run your own.```-## Reply 3 (the ask)+## Reply 3 (beyond this one repo)++Attach: media/github-100-stars-ecosystem.png++```+And three.ws does not stop at one repo.++111 open-source repos spun out of it, 1,222 stars between them: a 50-repo x402 suite, the Robinhood Chain family, standalone MCP servers, the AR Studio, on-chain agent wallets, the news archive.++ERC-8004 identity, reputation, and validation registries live on 12 EVM mainnets. Two Solana programs. 33 GPU and CPU workers as Docker images.++A Hugging Face org with a Space and a model repo. A Blender addon. ComfyUI nodes. A VS Code extension. Listed on the MCP registry, Smithery, Glama, PulseMCP, and x402scan.++All Apache-2.0.+```++## Reply 4 (the ask)```If you build AI agents, 3D, or on-chain payments, there is real open work waiting for you: the contributor guide hands out scoped issues, every package has a README, and every PR gets reviewed.diff --git a/scripts/render-github-stars-banner.mjs b/scripts/render-github-stars-banner.mjsindex 284938037..87c05d28e 100644--- a/scripts/render-github-stars-banner.mjs+++ b/scripts/render-github-stars-banner.mjs@@ -30,14 +30,29 @@ const STATS = [{ value: '725', label: 'public pages', sub: 'Apache-2.0, all of it' },];-function page({ width, height, square }) {+const ECOSYSTEM = [+ { value: '111', label: 'open-source repos', sub: 'spun out of three.ws' },+ { value: '1,222', label: 'stars across them', sub: 'github.com/nirholas' },+ { value: '12', label: 'EVM chains', sub: 'ERC-8004 registries, CREATE2' },+ { value: '2', label: 'Solana programs', sub: 'agent invocation, skill license' },+ { value: '33', label: 'GPU and CPU workers', sub: '27 Docker images' },+ { value: '1,752', label: 'test files', sub: '323 docs, 31 specs' },+ { value: '50', label: 'x402 suite repos', sub: 'standalone paid services' },+ { value: '3', label: 'Hugging Face', sub: 'org, Space, blog' },+ { value: '4', label: 'MCP directories', sub: 'registry, Smithery, Glama, PulseMCP' },+ { value: '2', label: 'editor integrations', sub: 'Blender addon, ComfyUI nodes' },+ { value: '2', label: 'store extensions', sub: 'VS Code, Open VSX, Chrome' },+ { value: '3', label: 'GitHub Pages apps', sub: 'AR Studio, deployer, wallets' },+];++function page({ width, height, square, stats = STATS, title = '100 stars', tagline = 'on GitHub. Thank you. Everything three.ws ships is open source.' }) {const cols = square ? 3 : 4;return `<!doctype html><html><head><meta charset="utf-8"><link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@500&display=swap" rel="stylesheet"><style>* { margin:0; padding:0; box-sizing:border-box; }html, body { width:${width}px; height:${height}px; background:#000; color:#fff; font-family:Inter, system-ui, sans-serif; overflow:hidden; }- .wrap { position:relative; width:100%; height:100%; padding:${square ? 56 : 48}px ${square ? 56 : 64}px; display:flex; flex-direction:column; justify-content:space-between; }+ .wrap { position:relative; width:100%; height:100%; padding:${square ? 48 : 40}px ${square ? 52 : 60}px; display:flex; flex-direction:column; justify-content:space-between; }.glow { position:absolute; inset:0; background:radial-gradient(ellipse 55% 45% at 78% 18%, rgba(140,120,255,.22), transparent 60%),radial-gradient(ellipse 45% 40% at 12% 88%, rgba(255,150,120,.14), transparent 60%);@@ -47,15 +62,19 @@ function page({ width, height, square }) {.lockup { height:${square ? 80 : 88}px; }.pill { display:inline-flex; align-items:center; gap:10px; padding:10px 18px; border:1px solid rgba(255,255,255,.18); border-radius:999px; font-size:${square ? 20 : 22}px; font-weight:500; color:rgba(255,255,255,.85); background:rgba(255,255,255,.04); letter-spacing:.01em; }.pill svg { width:22px; height:22px; fill:#fff; }- .hero { position:relative; display:flex; align-items:center; gap:${square ? 28 : 40}px; margin-top:${square ? 8 : 0}px; }- .star { width:${square ? 110 : 124}px; height:${square ? 110 : 124}px; flex:none; filter:drop-shadow(0 0 40px rgba(255,220,120,.45)); }- .hero h1 { font-size:${square ? 92 : 112}px; font-weight:800; line-height:.92; letter-spacing:-.045em; background:linear-gradient(120deg,#fff 0%,#dcd6ff 45%,#ffd9c7 100%); -webkit-background-clip:text; background-clip:text; color:transparent; }+ .hero { position:relative; display:flex; align-items:center; gap:${square ? 24 : 32}px; }+ .star { width:${square ? 96 : 108}px; height:${square ? 96 : 108}px; flex:none; filter:drop-shadow(0 0 40px rgba(255,220,120,.45)); }+ .hero h1 { font-size:${square ? 84 : 100}px; font-weight:800; line-height:.92; letter-spacing:-.045em; background:linear-gradient(120deg,#fff 0%,#dcd6ff 45%,#ffd9c7 100%); -webkit-background-clip:text; background-clip:text; color:transparent; }.hero p { margin-top:10px; font-size:${square ? 24 : 28}px; font-weight:500; color:rgba(255,255,255,.7); letter-spacing:-.01em; }.stats { position:relative; display:grid; grid-template-columns:repeat(${cols},1fr); gap:${square ? 10 : 12}px; }- .stat { padding:${square ? 14 : 16}px ${square ? 16 : 20}px; border:1px solid rgba(255,255,255,.12); border-radius:18px; background:linear-gradient(180deg, rgba(255,255,255,.06), rgba(255,255,255,.02)); }- .stat b { display:block; font-size:${square ? 34 : 38}px; font-weight:700; letter-spacing:-.03em; line-height:1; font-variant-numeric:tabular-nums; }+ .stat { padding:${square ? 11 : 12}px ${square ? 14 : 18}px; border:1px solid rgba(255,255,255,.12); border-radius:18px; background:linear-gradient(180deg, rgba(255,255,255,.06), rgba(255,255,255,.02)); }+ .stat b { display:block; font-size:${square ? 30 : 34}px; font-weight:700; letter-spacing:-.03em; line-height:1; font-variant-numeric:tabular-nums; }.stat span { display:block; margin-top:6px; font-size:${square ? 15 : 17}px; font-weight:600; color:rgba(255,255,255,.9); }.stat small { display:block; margin-top:2px; font-size:${square ? 12 : 13}px; color:rgba(255,255,255,.5); font-family:'JetBrains Mono', monospace; }+ .where { position:relative; }+ .where h2 { font-size:${square ? 13 : 14}px; font-weight:600; letter-spacing:.14em; text-transform:uppercase; color:rgba(255,255,255,.45); margin-bottom:${square ? 8 : 10}px; }+ .chips { display:flex; flex-wrap:wrap; gap:${square ? 6 : 8}px; }+ .chip { padding:${square ? 5 : 6}px ${square ? 11 : 13}px; border:1px solid rgba(255,255,255,.14); border-radius:999px; font-size:${square ? 14 : 16}px; font-weight:500; color:rgba(255,255,255,.82); background:rgba(255,255,255,.04); white-space:nowrap; }.foot { position:relative; display:flex; justify-content:space-between; align-items:center; font-size:${square ? 18 : 20}px; color:rgba(255,255,255,.55); font-family:'JetBrains Mono', monospace; }.foot b { color:rgba(255,255,255,.85); font-weight:500; }</style></head><body><div class="wrap">@@ -66,9 +85,9 @@ function page({ width, height, square }) {</div><div class="hero"><svg class="star" viewBox="0 0 24 24"><defs><linearGradient id="g" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#fff6d6"/><stop offset=".55" stop-color="#ffd166"/><stop offset="1" stop-color="#ff9f7a"/></linearGradient></defs><path fill="url(#g)" d="M12 1.8l3.1 6.5 7.1.9-5.2 4.9 1.3 7.1L12 17.8l-6.3 3.4L7 14.1 1.8 9.2l7.1-.9z"/></svg>- <div><h1>100 stars</h1><p>on GitHub. Thank you. Everything three.ws ships is open source.</p></div>+ <div><h1>${title}</h1><p>${tagline}</p></div></div>- <div class="stats">${STATS.map(s => `<div class="stat"><b>${s.value}</b><span>${s.label}</span><small>${s.sub}</small></div>`).join('')}</div>+ <div class="stats">${stats.map(s => `<div class="stat"><b>${s.value}</b><span>${s.label}</span><small>${s.sub}</small></div>`).join('')}</div><div class="foot"><span>Star the repo: <b>github.com/nirholas/three.ws</b></span><span><b>three.ws</b> · $THREE</span></div></div></body></html>`;}@@ -78,6 +97,7 @@ try {for (const v of [{ file: 'github-100-stars-x.png', width: 1600, height: 900, square: false },{ file: 'github-100-stars-square.png', width: 1080, height: 1080, square: true },+ { file: 'github-100-stars-ecosystem.png', width: 1600, height: 900, square: false, stats: ECOSYSTEM, title: 'One repo, everywhere', tagline: 'Where the three.ws open-source ecosystem stems beyond github.com/nirholas/three.ws.' },]) {const ctx = await browser.newContext({ viewport: { width: v.width, height: v.height }, deviceScaleFactor: 1.5 });const p = await ctx.newPage();