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.

docs(marketing): give the 100-stars post a people-and-actions version so it does not repeat the numbers the article post already used

nirholas78c85631347b
diff --git a/docs/media/github-100-stars-people.png b/docs/media/github-100-stars-people.png
new file mode 100644
index 000000000..7382dbffe
Binary files /dev/null and b/docs/media/github-100-stars-people.png differ
diff --git a/docs/x-posts/github-100-stars.md b/docs/x-posts/github-100-stars.md
index a6bd60787..54c5c6b25 100644
--- a/docs/x-posts/github-100-stars.md
+++ b/docs/x-posts/github-100-stars.md
@@ -1,6 +1,6 @@
# 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, 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.
+Post copy for the 100-star milestone on X. Posting is owner-gated; these are ready-to-paste drafts. Attach [media/github-100-stars-people.png](../media/github-100-stars-people.png) (2400x1350, real contributor avatars pulled from GitHub at render time, plus three install commands) to the Version A main post, [media/github-100-stars-x.png](../media/github-100-stars-x.png) (twelve stat tiles) to the Version B 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` 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.
@@ -29,7 +29,92 @@ Regenerate both images with `node scripts/render-github-stars-banner.mjs` after
| 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)
+## Which version to post
+
+The First 19 Weeks article post (August 25) already led with the headline numbers (9,508 commits, 21 contributors, 101 npm packages, 72 MCP servers, 4,519 x402 endpoints, 110,416 settlements). Do not repeat them six hours later. Post **Version A**, which is about the people and what you can do with the repo in a minute, and keeps the numbers out of the main post entirely. **Version B** is the numbers-first thread, kept here for a channel that has not seen the article post yet (LinkedIn, a newsletter, the IBM Community group).
+
+---
+
+## Version A: people and actions (post this on X)
+
+### Main post (@trythreews)
+
+Attach: media/github-100-stars-people.png
+
+```
+100 stars on GitHub. Thank you.
+
+Every one of them came from someone who chose to build in the open with us: nine contributors with commits on main, forks, issues, pull requests, and a lot of people who just read the code and told us where it was wrong.
+
+three.ws is Apache-2.0, end to end. The 3D avatars, the wallets, the x402 rails, the MCP servers, the GPU workers. Here is how to use it in the next 60 seconds.
+```
+
+### Reply 1 (60 seconds)
+
+```
+Three ways in, no account needed:
+
+npm i @three-ws/sdk
+An avatar with a wallet, in any app.
+
+/plugin marketplace add nirholas/three.ws
+Four Claude Code plugins: core, developer, pump.fun, 3D.
+
+npx -y @three-ws/x402-mcp
+Let your agent pay any x402 endpoint from its own wallet.
+```
+
+### Reply 2 (open work, for newcomers)
+
+```
+Want your name on the next 100? Five issues are tagged good first issue right now, all scoped to one file and one test:
+
+Map Apple ARKit skeletons so their avatars animate
+Map Kinect bone names
+Map Reallusion CC3/CC4 spines
+Bake a real "bow" clip
+Guard the rig docs against drift
+
+github.com/nirholas/three.ws/issues
+```
+
+### Reply 3 (the places that noticed)
+
+Attach: media/github-100-stars-ecosystem.png
+
+```
+Open source is why the rest happened.
+
+IBM built a three.ws User Group on IBM Community and hosted our first in-world meetup. AWS published three of our articles on Builder Center. NVIDIA took us into Inception. OpenAI put 3D Studio in the GPT Store. Alibaba Cloud listed us. Google Cloud backed the GPUs.
+
+None of that starts with a pitch deck. It starts with a repo anyone can read.
+```
+
+### Reply 4 (the ask)
+
+```
+Star it if it helped you. Fork it if you want to change it. Open a PR if you did.
+
+github.com/nirholas/three.ws
+
+$THREE is the coin in the middle of it.
+```
+
+### Telegram (@three_ws)
+
+Attach: media/github-100-stars-square.png
+
+```
+100 stars on GitHub. Thank you to everyone who starred, forked, filed, and shipped. Everything three.ws runs is open source under Apache-2.0, and five good-first-issues are open right now for anyone who wants their name in the next hundred.
+
+github.com/nirholas/three.ws
+```
+
+---
+
+## Version B: numbers first (for channels that have not seen the article post)
+
+### Main post
Attach: media/github-100-stars-x.png
@@ -48,7 +133,7 @@ Thank you to everyone who starred, forked, opened an issue, or shipped a PR. Eve
github.com/nirholas/three.ws
```
-## Reply 1 (the scale of it)
+### Reply 1 (the scale of it)
```
100 stars understates it. In 19 weeks this one repo became:
@@ -64,7 +149,7 @@ ERC-8004 identity, reputation, and validation registries at one address on 12 EV
All Apache-2.0. All in one place.
```
-## Reply 2 (the machine economy, in numbers)
+### Reply 2 (the machine economy, in numbers)
```
The x402 side of the repo is not a demo:
@@ -77,7 +162,7 @@ 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 (beyond this one repo)
+### Reply 3 (beyond this one repo)
Attach: media/github-100-stars-ecosystem.png
@@ -93,7 +178,7 @@ A Hugging Face org with a Space and a model repo. A Blender addon. ComfyUI nodes
All Apache-2.0.
```
-## Reply 4 (the partners and platforms)
+### Reply 4 (the partners and platforms)
```
And the places that noticed:
@@ -107,7 +192,7 @@ Alibaba Cloud Marketplace: live listing. Google Cloud for Web3 Startups: member.
Every link, with the number behind it: three.ws/docs/open-source-footprint
```
-## Reply 5 (the ask)
+### Reply 5 (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.
@@ -118,7 +203,7 @@ github.com/nirholas/three.ws
$THREE is the coin in the middle of it.
```
-## Telegram (@three_ws)
+### Telegram (@three_ws)
Attach: media/github-100-stars-square.png
diff --git a/scripts/render-github-stars-banner.mjs b/scripts/render-github-stars-banner.mjs
index 408f2f1be..a42bdd1e8 100644
--- a/scripts/render-github-stars-banner.mjs
+++ b/scripts/render-github-stars-banner.mjs
@@ -99,16 +99,74 @@ function page({ width, height, square, surfaces = null, stats = STATS, title = '
</div></body></html>`;
}
+// The people variant pulls the real contributor avatars from GitHub at render
+// time. The "claude" login is a misattributed noreply email, not a person.
+async function fetchContributors() {
+ const res = await fetch('https://api.github.com/repos/nirholas/three.ws/contributors?per_page=100', { headers: { 'User-Agent': 'three.ws-banner' } });
+ if (!res.ok) throw new Error(`GitHub contributors API ${res.status}`);
+ const list = (await res.json()).filter((c) => c.type === 'User' && c.login !== 'claude');
+ return Promise.all(list.map(async (c) => {
+ const img = await fetch(`${c.avatar_url}&s=200`);
+ if (!img.ok) throw new Error(`avatar ${c.login} ${img.status}`);
+ return { login: c.login, b64: Buffer.from(await img.arrayBuffer()).toString('base64') };
+ }));
+}
+
+const COMMANDS = [
+ ['npm i @three-ws/sdk', 'an avatar with a wallet, in any app'],
+ ['/plugin marketplace add nirholas/three.ws', 'four Claude Code plugins'],
+ ['npx -y @three-ws/x402-mcp', 'pay any x402 endpoint from an agent'],
+];
+
+function peoplePage({ width, height, people }) {
+ 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:48px 64px; 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%); }
+ .grid { position:absolute; inset:0; background-image:linear-gradient(rgba(255,255,255,.035) 1px, transparent 1px), linear-gradient(90deg, rgba(255,255,255,.035) 1px, transparent 1px); background-size:48px 48px; mask-image:radial-gradient(ellipse 70% 70% at 50% 50%, #000 30%, transparent 100%); }
+ .top { position:relative; display:flex; align-items:center; justify-content:space-between; }
+ .lockup { height:84px; }
+ .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:20px; font-weight:500; color:rgba(255,255,255,.85); background:rgba(255,255,255,.04); }
+ .hero { position:relative; display:flex; align-items:center; gap:32px; }
+ .star { width:108px; height:108px; flex:none; filter:drop-shadow(0 0 40px rgba(255,220,120,.45)); }
+ h1 { font-size:100px; 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:26px; font-weight:500; color:rgba(255,255,255,.7); }
+ .people { position:relative; }
+ .people h2, .try h2 { font-size:14px; font-weight:600; letter-spacing:.14em; text-transform:uppercase; color:rgba(255,255,255,.45); margin-bottom:12px; }
+ .faces { display:flex; gap:14px; flex-wrap:wrap; }
+ .face { display:flex; flex-direction:column; align-items:center; gap:8px; width:120px; }
+ .face img { width:88px; height:88px; border-radius:50%; border:2px solid rgba(255,255,255,.22); box-shadow:0 0 0 4px rgba(0,0,0,.6); object-fit:cover; }
+ .face span { font-family:'JetBrains Mono', monospace; font-size:14px; color:rgba(255,255,255,.7); max-width:120px; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
+ .try { position:relative; display:grid; grid-template-columns:repeat(3,1fr); gap:12px; }
+ .cmd { padding:14px 18px; border:1px solid rgba(255,255,255,.12); border-radius:16px; background:linear-gradient(180deg, rgba(255,255,255,.06), rgba(255,255,255,.02)); }
+ .cmd code { display:block; font-family:'JetBrains Mono', monospace; font-size:19px; color:#fff; white-space:nowrap; }
+ .cmd small { display:block; margin-top:6px; font-size:15px; color:rgba(255,255,255,.55); }
+ .foot { position:relative; display:flex; justify-content:space-between; font-size:18px; 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"><div class="glow"></div><div class="grid"></div>
+ <div class="top"><img class="lockup" src="data:image/png;base64,${lockup}" alt="three.ws"><div class="pill">github.com/nirholas/three.ws</div></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. Thank you.</h1><p>Every star, fork, issue, and pull request came from someone who chose to build in the open with us.</p></div></div>
+ <div class="people"><h2>Built by</h2><div class="faces">${people.map((p) => `<div class="face"><img src="data:image/jpeg;base64,${p.b64}" alt="${p.login}"><span>${p.login}</span></div>`).join('')}<div class="face"><div style="width:88px;height:88px;border-radius:50%;border:2px dashed rgba(255,255,255,.35);display:flex;align-items:center;justify-content:center;font-size:40px;color:rgba(255,255,255,.6)">+</div><span>you</span></div></div></div>
+ <div class="try"><h2 style="grid-column:1/-1;margin-bottom:0">Try it in 60 seconds</h2>${COMMANDS.map(([c, d]) => `<div class="cmd"><code>${c}</code><small>${d}</small></div>`).join('')}</div>
+ <div class="foot"><span>Star the repo: <b>github.com/nirholas/three.ws</b></span><span><b>three.ws</b> · Apache-2.0 · $THREE</span></div>
+</div></body></html>`;
+}
+
const browser = await chromium.launch();
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, surfaces: SURFACES, title: 'One repo, everywhere', tagline: 'Where the three.ws open-source ecosystem stems beyond github.com/nirholas/three.ws.' },
+ { file: 'github-100-stars-people.png', width: 1600, height: 900, people: true },
]) {
const ctx = await browser.newContext({ viewport: { width: v.width, height: v.height }, deviceScaleFactor: 1.5 });
const p = await ctx.newPage();
- await p.setContent(page(v), { waitUntil: 'networkidle' });
+ await p.setContent(v.people ? peoplePage({ ...v, people: await fetchContributors() }) : page(v), { waitUntil: 'networkidle' });
await p.evaluate(() => document.fonts.ready);
await p.screenshot({ path: resolve(outDir, v.file), type: 'png' });
await ctx.close();