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(changelog): tell holders the expired X connection now offers a reconnect, and regenerate the feeds
nirholas2e7daf6ec2f4
diff --git a/docs/api-reference.md b/docs/api-reference.mdindex beb4059a2..cbad8995b 100644--- a/docs/api-reference.md+++ b/docs/api-reference.md@@ -609,6 +609,201 @@ Requires auth. Deletes a single memory by its platform ID.---+## Memory seed connectors API++Public-footprint readers that turn an account handle into the raw material for a+memory seed, plus the synthesizer that writes the seed itself. This is the lane+behind [/demos/memory-seed](https://three.ws/demos/memory-seed) and the seed+widget in `src/memory-seed.js`.++Everything these endpoints read is already public. They are read-only, request+no OAuth from the visitor, and store nothing; the consent-gated seeding flows+that do write to an agent live at `/api/agents/:id/memory/seed/*` and are+documented in [GitHub](./github-memory-seeding.md), [X](./x-memory-seeding.md)+and [Farcaster](./farcaster-memory-seeding.md) memory seeding.++The three connectors are unauthenticated GETs, rate limited per IP, and cached+at the edge for 5 minutes. A connector that cannot reach its upstream answers+`200` with `{ "ok": false, "reason", "detail" }` so a partly-configured+deployment degrades to a greyed-out card instead of a failed page; a bad handle+is still a `4xx`.++### GitHub footprint++```+GET /api/seed/github?handle=<user>+```++No credentials required. `GITHUB_TOKEN` is used when present, purely for the+higher rate limit.++```bash+curl -s 'https://three.ws/api/seed/github?handle=nirholas'+```++```json+{+ "ok": true,+ "handle": "nirholas",+ "name": "nich",+ "bio": "",+ "followers": 617,+ "public_repos": 223,+ "top_repos": [+ {+ "name": "fresh-start",+ "description": "The original repo, restored.",+ "stars": 6250,+ "language": null,+ "html_url": "https://github.com/nirholas/fresh-start"+ }+ ],+ "top_readme_excerpt": "# fresh-start"+}+```++Errors: `400 invalid_request` (no handle), `400 invalid_handle` (illegal+characters), `404 not_found` (no such user), `502 upstream_error`.++---++### Farcaster footprint++```+GET /api/seed/farcaster?handle=<fname-or-fid>+```++No credentials required. Reads through the platform's shared Farcaster client,+which prefers Neynar when `NEYNAR_API_KEY` is set and otherwise falls back to a+public Farcaster hub over HTTP (`FARCASTER_HUB_URL`, default+`https://hub.pinata.cloud`).++`lane` names the rung that answered. The hub serves raw protocol messages and+therefore has no reaction counts, so `follower_count`, `following_count` and+per-cast `engagement` are `null` on that lane rather than `0`. Casts are ranked+by engagement where the lane knows it and by recency where it does not, with+replies, link-only posts and duplicates dropped.++```bash+curl -s 'https://three.ws/api/seed/farcaster?handle=dwr'+```++```json+{+ "ok": true,+ "lane": "hub",+ "handle": "dwr",+ "fid": 3,+ "display_name": "Dan Romero",+ "bio": "Working on Farcaster",+ "follower_count": null,+ "recent_casts": [+ {+ "text": "Best store-bought eggnog available on the west coast",+ "timestamp": "2025-11-28T01:35:34.000Z",+ "engagement": null+ }+ ]+}+```++Errors: `400 invalid_request`, `400 invalid_handle`, `404 not_found`. A hub+answers an unknown fname with `400` and a `NotFound` detail; that is normalised+to a `404` here so a typo cannot read as an outage.++---++### X footprint++```+GET /api/seed/x?handle=<user>+```++X has no keyless public read lane, so this connector needs one of two credential+sets and reports `ok: false` without either:++1. `TWITTER_BEARER_TOKEN`, an app-only bearer from the developer portal.+2. `X_API_KEY` + `X_API_SECRET`, the OAuth 1.0a consumer pair. The handler+ exchanges them for an app-only bearer at runtime via `appLogin()`, so a+ deployment that already holds the changelog poster's app credentials needs+ nothing new provisioned.++```bash+curl -s 'https://three.ws/api/seed/x?handle=jack'+```++```json+{+ "ok": true,+ "handle": "jack",+ "name": "jack",+ "bio": "no state is the best state",+ "follower_count": 11300858,+ "tweet_count": 30894,+ "recent_tweets": [+ {+ "text": "joel is awesome",+ "created_at": "2026-08-10T21:54:11.000Z",+ "likes": 1458,+ "retweets": 87,+ "replies": 115+ }+ ],+ "top_topics": [{ "topic": "agents", "count": 4 }]+}+```++Errors: `400 invalid_request`, `400 invalid_handle`, `404 not_found`. A rate+limit or outage on the timeline read keeps the profile payload and returns an+empty `recent_tweets` rather than failing the request.++---++### Synthesize a memory seed++```+POST /api/seed/synthesize+```++Requires auth (session cookie or bearer token). Takes any subset of the three+connector payloads verbatim and returns a 200-300 word markdown memory seed. The+completion runs on the platform LLM chain (`api/_lib/llm.js`), which leads with+free and keyless providers, so no provider key is required.++**Request body**++```json+{+ "connectors": {+ "github": { "ok": true, "handle": "nirholas", "top_repos": [] },+ "x": { "ok": true, "handle": "jack" },+ "farcaster": { "ok": true, "handle": "dwr", "fid": 3 }+ }+}+```++Connector payloads carrying `ok: false` are ignored. At least one usable payload+is required.++**Response**++```json+{+ "ok": true,+ "memory_seed": "### Interests\nThe user is a prolific builder...",+ "sources_used": ["github", "x", "farcaster"],+ "tokens_used": 2670,+ "usage": { "input_tokens": 2300, "output_tokens": 370 },+ "model": "gemini-3.1-flash-lite"+}+```++Errors: `401 unauthorized`, `400 validation_error` (unknown key, or no connector+supplied), `400 no_signal` (every payload unusable), `429+daily_spend_cap_exceeded`, `502 upstream_error`, `503 llm_unavailable`.++---+## Chat / LLM API### Agent chatdiff --git a/docs/start-here.md b/docs/start-here.mdindex f2293bca1..d691aff06 100644--- a/docs/start-here.md+++ b/docs/start-here.md@@ -186,6 +186,7 @@ Deeper references that don't fit a track above but answer real questions:- [Farcaster memory seeding](./farcaster-memory-seeding.md): give an agent your Farcaster voice, proved with a wallet the account already verified, and revoke it in one click- [X memory seeding](./x-memory-seeding.md): 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](./github-memory-seeding.md): 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](./api-reference.md#memory-seed-connectors-api): 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](./seed-quality.md): 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](./likeness-eval.md): 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](./examples.md): copy-paste-ready code for common use casesdiff --git a/docs/syndication.md b/docs/syndication.mdindex 8a54a1635..1bf9cdf3b 100644--- a/docs/syndication.md+++ b/docs/syndication.md@@ -14,6 +14,54 @@ items in `data/rss/items.json` may still carry a `syndication` fieldrecording where they were mirrored at publish time; it is inertmetadata.+## Feed URLs and sources++`https://three.ws/rss/announcements.xml` and the shorter+`https://three.ws/rss.xml` serve the same feed. Both accept one optional+query parameter, `source`, which selects what the feed is built from:++| `?source=` | Feed contents |+| --- | --- |+| omitted, or `curated` | The hand-edited items in `data/rss/items.json`. This is what HackerNoon and every public subscriber reads. |+| `trythreews` | Announcements archived from [@trythreews](https://x.com/trythreews). |+| `nichxbt` | Announcements archived from [@nichxbt](https://x.com/nichxbt). |+| `archive` | Both archived accounts, merged and de-duplicated, newest first. |++The value is case-insensitive. Anything else is a `400` with+`{"error":"unknown_source"}` rather than a silent fall-back to the+curated feed, so a subscriber who mistypes a source finds out instead of+quietly receiving a different feed forever. Responses are cached for ten+minutes at the edge and are `application/rss+xml`; the endpoint is+read-only and answers `GET`, `HEAD`, and `OPTIONS` only.++Fetch it from anywhere:++```bash+curl -s 'https://three.ws/rss/announcements.xml' | xmllint --noout - && echo 'valid feed'+```++### Why feed validity is load-bearing++XML has no partial failure: one illegal byte anywhere in the document+makes the *whole* feed unreadable, so a single bad post takes every+subscriber offline rather than dropping one item. The builder in+[`api/_lib/rss-feed.js`](../api/_lib/rss-feed.js) therefore neutralizes+the three inputs that can do that, and+[`tests/rss-announcements.test.js`](../tests/rss-announcements.test.js)+pins each one:++- **A `]]>` inside an item body**, which would close the `CDATA` section+ early. It is re-emitted across two sections so it survives as text.+- **Characters XML 1.0 forbids** (control bytes other than tab, newline+ and carriage return; unpaired surrogates). Escaping cannot rescue+ these, so they are dropped. Real astral characters and emoji are kept.+- **Prose that spells the linkifier's internal URL placeholder.** The+ placeholder is a form escaped text cannot contain, so a post can never+ be mistaken for a link the builder set aside.++Editing `data/rss/items.json` by hand is safe against all three, but run+the `curl | xmllint` check above after a deploy that touches the feed.+## HackerNoonHackerNoon is one of the world's largest independent tech publications.diff --git a/public/changelog.json b/public/changelog.jsonindex 356ba5dc8..cd52e4555 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-16T07:25:09.580Z",+ "generated_at": "2026-08-16T07:25:32.439Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",diff --git a/public/features.json b/public/features.jsonindex 6008f0d77..49722c821 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-16T07:25:09.436Z",+ "generated_at": "2026-08-16T07:25:32.328Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",diff --git a/public/llms-full.txt b/public/llms-full.txtindex 714124bc5..309ea4d66 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -3135,7 +3135,7 @@ three.ws is built around two distinct concepts: agents are AI minds, avatars areURL: https://three.ws/docs/animations-The motion clips (idle, wave, dance, and about 2,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.+The motion clips (idle, wave, dance, and about 3,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.### Docs · Choreographydiff --git a/public/llms.txt b/public/llms.txtindex 158c33ce9..4af584317 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -556,7 +556,7 @@ Docs, tutorials, and reference.- [Docs · The three.ws Agent Skills pack](https://three.ws/docs/agent-skills): Portable skill folders that teach any Claude surface (Claude Code, the Claude apps, the Agent SDK) how to use three.ws: 3D creation, wallets, and paid services. The 3D subset is cross-platform-safe and needs no credentials.- [Docs · Agent wallets](https://three.ws/docs/agent-wallets): Every three.ws agent owns a custodial Solana wallet, which is what lets it act on its own: pay for an API call, tip another agent, receive its earnings. Custody model, funding, limits, and the controls around spending.- [Docs · Agents vs. avatars](https://three.ws/docs/agents-vs-avatars): three.ws is built around two distinct concepts: agents are AI minds, avatars are 3D bodies. The short, plain-language explanation of which is which, how they combine, and why the distinction matters when you go looking for a feature.-- [Docs · Animations](https://three.ws/docs/animations): The motion clips (idle, wave, dance, and about 2,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.+- [Docs · Animations](https://three.ws/docs/animations): The motion clips (idle, wave, dance, and about 3,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.- [Docs · Choreography](https://three.ws/docs/choreography): The developer reference for agent gesture routines: the routine format, the storage and manifest fields, the URL wire format that makes a link a routine, and every way to play one from an embed or your own renderer.- [Docs · Architecture overview](https://three.ws/docs/architecture): The engineering map of three.ws: how a request flows from the browser through the route table to a handler, where 3D generation runs, how state is stored, and which layer to extend when you want to add something.- [Docs · Avatar creation](https://three.ws/docs/avatar-creation): The three ways to give an agent a 3D body: generate one from a photo, build one in the browser with the avatar builder, or upload your own GLB. What each path costs, what each produces, and when to choose which.diff --git a/public/locales/localized-pages.json b/public/locales/localized-pages.jsonindex 702a23773..bebdda5a4 100644--- a/public/locales/localized-pages.json+++ b/public/locales/localized-pages.json@@ -1,6 +1,6 @@{"generated": true,- "count": 355,+ "count": 243,"paths": ["/","/3d",@@ -157,118 +157,6 @@"/mocap-studio","/motion-swap","/my-agents",- "/news",- "/news/",- "/news/2045242891350814835",- "/news/2049397875935989970",- "/news/2049406826719137937",- "/news/2049412062837928202",- "/news/2049447738434339171",- "/news/2049458671139336613",- "/news/2049476546285740512",- "/news/2049557523330638269",- "/news/2049573582247022869",- "/news/2049576603324411933",- "/news/2049576641127682430",- "/news/2049577291957899336",- "/news/2049762836881301865",- "/news/2049765915575914834",- "/news/2049997615421649363",- "/news/2050016695897706885",- "/news/2050049239301165535",- "/news/2050221269732425928",- "/news/2050226678321102975",- "/news/2050229144676675999",- "/news/2050284562069266616",- "/news/2050585585191186781",- "/news/2050627547394916768",- "/news/2050753406109880576",- "/news/2050758788186353723",- "/news/2050800140295049308",- "/news/2050886334261391686",- "/news/2051140736201175323",- "/news/2051261108506558901",- "/news/2051616708482498843",- "/news/2051689230997618690",- "/news/2051690803203105230",- "/news/2051774915876098063",- "/news/2051858035862335505",- "/news/2051858503523066283",- "/news/2051893054584553680",- "/news/2052037977556287723",- "/news/2052167399399735476",- "/news/2052181307002929363",- "/news/2052189491801284690",- "/news/2052402481024667887",- "/news/2052402580266098813",- "/news/2052418108837781511",- "/news/2052418482269254040",- "/news/2052426446073983267",- "/news/2052588973466484922",- "/news/2052603250524967045",- "/news/2052685648377913671",- "/news/2052790746256920583",- "/news/2052791935585407403",- "/news/2053025259645981078",- "/news/2053698115203743922",- "/news/2053698387263008827",- "/news/2053730856339144932",- "/news/2053801703355629587",- "/news/2053804700609458214",- "/news/2053832201176027583",- "/news/2054404663802483072",- "/news/2054675701132132736",- "/news/2055140064070717618",- "/news/2055307440921702738",- "/news/2055309846556401735",- "/news/2055310365588922872",- "/news/2055517252964024561",- "/news/2055967730495586477",- "/news/2055985494606106821",- "/news/2056556899403997450",- "/news/2057721370310775223",- "/news/2057780453709648200",- "/news/2057782522994684413",- "/news/2057786164862730704",- "/news/2058076885805085111",- "/news/2058287578227577039",- "/news/2059456289789657537",- "/news/2059456294189498830",- "/news/2059456295825223723",- "/news/2059457822941978723",- "/news/2059675892981633179",- "/news/2059712761622675776",- "/news/2059821472156446844",- "/news/2059894004771418220",- "/news/2060178868305326413",- "/news/2060186881636422038",- "/news/2061418285896269952",- "/news/2061488909264040194",- "/news/2061523804405616642",- "/news/2061713039624405062",- "/news/aws-agentic-economy-three-ws",- "/news/aws-builder-center-3d-agents-onchain-payments",- "/news/aws-builder-center-blog",- "/news/aws-marketplace-live-may29",- "/news/bybit-alpha-listing",- "/news/cmc-mcp-registry-article",- "/news/cmc-memecoin-3d-world",- "/news/ibm-collaboration-showcase",- "/news/ibm-showcase-may31",- "/news/joined-aws-partner-network",- "/news/listed-on-bnb-chain-dappbay",- "/news/live-on-alibaba-cloud-marketplace",- "/news/live-on-aws-marketplace",- "/news/mcp-servers-x402-bazaar-coinbase",- "/news/monetize-mcp-server-x402-paid-tools",- "/news/moonshot-verified",- "/news/partnered-with-hackernoon",- "/news/quicknode-startup-program",- "/news/text-to-3d-is-live",- "/news/three-ws-dextools-social-boost-buyback",- "/news/three-ws-featured-on-alibaba-cloud-marketplace-blog",- "/news/three-ws-first-month-3d-agent-layer",- "/news/threews-play-coin-communities","/nim-forge","/notifications","/nvidia",diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex 4c378c38f..e8d68c0fe 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -3831,7 +3831,7 @@<a href="/docs/animations"><span class="sm-title">Docs · Animations</span><span class="sm-path">/docs/animations</span>- <span class="sm-desc">The motion clips (idle, wave, dance, and about 2,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.</span>+ <span class="sm-desc">The motion clips (idle, wave, dance, and about 3,000 more) that bring three.ws avatars to life: how the registry is organised, how clips load at runtime, how they retarget onto any humanoid rig, and how to preview every one in the browser.</span></a></li><li>