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
feat(awesome): make the list pass awesome-lint and grow it to 152 entries
nirholasbffe1324f167
diff --git a/STRUCTURE.md b/STRUCTURE.mdindex 3496c5adf..d2d0d9a3a 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -207,7 +207,7 @@ bottom.| Escrowed knocks (pay-per-reply) | [contracts/knock-escrow/](contracts/knock-escrow) | In-repo | Anchor program making a knock's payment conditional instead of final: `knock` parks the price in a vault owned by the knock's own PDA, and only three things can happen to it. `answer` pays the owner minus a fee capped at 10% in the program itself, `refuse` refunds the sender in full and takes no fee, and `reclaim` refunds the sender once the reply window closes and can be called by anyone. Each `KnockRecord` snapshots the fee that was in force when it was made, so an authority cannot reprice money already in escrow, and it stores only the SHA-256 of the message and the reply, never their text. The trust-me version of this settles straight to the owner at [api/knock/](api/knock) (row above); this is the version that works between strangers. Both sides are reachable from a browser: senders escrow and crank their own refund from the door page, owners open their on-chain door, answer for payment or refuse for a refund from [/knock](pages/knock.html), all signed by their own wallet ([src/knock/escrow-checkout.js](src/knock/escrow-checkout.js)). Docs: [contracts/knock-escrow/README.md](contracts/knock-escrow/README.md), [docs/knock.md](docs/knock.md). Tests: [tests/knock-escrow-program.test.js](tests/knock-escrow-program.test.js), [tests/knock-escrow-pda.test.js](tests/knock-escrow-pda.test.js), [tests/api-knock-escrowed.test.js](tests/api-knock-escrowed.test.js), [tests/api-knock-escrow-sync.test.js](tests/api-knock-escrow-sync.test.js) || Cross-chain SDKs | [sdk/](sdk), [solana-agent-sdk/](solana-agent-sdk), [agent-payments-sdk/](agent-payments-sdk), [agent-protocol-sdk/](agent-protocol-sdk) | Published | Cross-chain agent SDKs || MCP integration | [mcp-server/](mcp-server), [mcp-bridge/](mcp-bridge), [packages/*-mcp/](packages) | 43 npm servers + 7 hosted remote (50 total, incl. the free `/api/mcp-studio` 3D Studio), all in the [MCP registry](https://registry.modelcontextprotocol.io/?q=io.github.nirholas). Canonical metadata: [prompts/store-submissions/_generated/mcp-listing-source.json](prompts/store-submissions/_generated/mcp-listing-source.json), generated from the manifests by [scripts/build-mcp-listing-source.mjs](scripts/build-mcp-listing-source.mjs) (`npm run audit:mcp-listing` fails when it drifts) | Model Context Protocol surface, full server list in [docs/mcp.md](docs/mcp.md). Searchable index of every tool: [pages/mcp-tools.html](pages/mcp-tools.html) `→ /mcp-tools`, rendered from the generated [public/mcp-catalog.json](public/mcp-catalog.json) ([scripts/build-mcp-catalog.mjs](scripts/build-mcp-catalog.mjs), `npm run build:mcp-catalog`, staleness gated by `npm run audit:mcp-catalog`). Tool safety annotations are verified against each handler by [scripts/audit-mcp-safety.mjs](scripts/audit-mcp-safety.mjs) (`npm run audit:mcp-safety`, rules in [scripts/lib/mcp-safety-check.mjs](scripts/lib/mcp-safety-check.mjs), guarded-file list shared with the golden snapshot via [scripts/lib/mcp-tool-sources.mjs](scripts/lib/mcp-tool-sources.mjs)); docs [docs/mcp-safety.md](docs/mcp-safety.md) `→ /docs/mcp-safety`. Trust policy: [api/mcp-policy.js](api/mcp-policy.js) `-> GET /api/mcp-policy` turns those verified labels into a ready-to-paste client allowlist (profiles strict/balanced/open x formats claude/vscode/json), surfaced by the builder panel on `/mcp-tools`. Connector-review readiness (every paid stdio tool answers a clean x402 challenge, and the reviewer entitlement lifts it): [scripts/audit-mcp-reviewer-path.mjs](scripts/audit-mcp-reviewer-path.mjs), `npm run audit:mcp-reviewer`. Tests: [tests/mcp-safety-audit.test.js](tests/mcp-safety-audit.test.js), [tests/mcp-catalog.test.js](tests/mcp-catalog.test.js), [tests/api/mcp-policy.test.js](tests/api/mcp-policy.test.js) |-| Awesome 3D Agents (curated list) | Source [data/awesome.json](data/awesome.json), generator [scripts/build-awesome.mjs](scripts/build-awesome.mjs) (`npm run build:awesome`, drift-gated by `npm run check:awesome`), outputs [awesome/README.md](awesome/README.md) + [public/awesome.json](public/awesome.json), page [pages/awesome.html](pages/awesome.html) `-> /awesome`, link checker [scripts/check-awesome-links.mjs](scripts/check-awesome-links.mjs) (`npm run awesome:links`) | Live | An awesome-list of everything needed to give an AI agent a body: text-to-3D, capture and splatting, avatars, rigging, motion, lipsync and voice, web renderers, asset pipelines, physics and networking, agent frameworks, datasets, free assets, learning. One JSON source produces both the GitHub-facing list and the searchable page, so they cannot disagree. Every url is fetched and classified (ok / moved / bot-filtered / broken) before it ships; the checker stays out of the deploy path so a third-party outage cannot redden someone else's build. Contributing: [awesome/CONTRIBUTING.md](awesome/CONTRIBUTING.md) |+| Awesome 3D Agents (curated list) | Source [data/awesome.json](data/awesome.json), generator [scripts/build-awesome.mjs](scripts/build-awesome.mjs) (`npm run build:awesome`, drift-gated by `npm run check:awesome`, publishable mirror via `npm run awesome:standalone`), outputs [awesome/README.md](awesome/README.md) + [public/awesome.json](public/awesome.json), page [pages/awesome.html](pages/awesome.html) `-> /awesome`, link checker [scripts/check-awesome-links.mjs](scripts/check-awesome-links.mjs) (`npm run awesome:links`) | Live | An awesome-list of everything needed to give an AI agent a body: text-to-3D, capture and splatting, avatars, rigging, motion, lipsync and voice, web renderers, asset pipelines, physics and networking, agent frameworks, datasets, free assets, learning. One JSON source produces both the GitHub-facing list and the searchable page, so they cannot disagree. Every url is fetched and classified (ok / moved / bot-filtered / broken) before it ships; the checker stays out of the deploy path so a third-party outage cannot redden someone else's build. The README is written to pass `npx awesome-lint`: badge on the heading line, no License section, no Contributing entry in the contents, and every description capitalised and ended with a period, all enforced by the generator and by [tests/awesome-list.test.js](tests/awesome-list.test.js). Its last two lint rules read GitHub repository topics, which a list inside a product repo cannot satisfy, so `--standalone` emits a ready-to-publish mirror repo (readme, contributing, code of conduct, license) outside this checkout. Contributing: [awesome/CONTRIBUTING.md](awesome/CONTRIBUTING.md) || Agent Skills pack | [.agents/skills/](.agents/skills) → manifest [.agents/skills/SKILLS.md](.agents/skills/SKILLS.md), [.agents/skills/skills-pack.json](.agents/skills/skills-pack.json) | In-repo; bundled in the `three-ws-core` [plugin](.claude-plugin/marketplace.json) | 40 portable `SKILL.md` folders (Agent Skills open standard) for any Claude surface — 3d/creative (cross-platform-safe), wallet/payments, intel/trading. Regenerate manifest: `node scripts/build-skills-pack.mjs`. Docs: [docs/agent-skills.md](docs/agent-skills.md) || Claude Code plugin marketplace | [marketplace/](marketplace) → plugins [three-ws-3d](marketplace/plugins/three-ws-3d), [three-ws-developer](marketplace/plugins/three-ws-developer) | In-repo · installable via `/plugin marketplace add nirholas/three.ws` | 3D generation + rigged avatars inside Claude Code (free lane + paid x402 tools) and developer tooling for building on three.ws. Index: [marketplace/README.md](marketplace/README.md) || SNS naming + pay-by-name | [api/sns.js](api/sns.js), [api/sns-subdomain.js](api/sns-subdomain.js), [api/threews/subdomain.js](api/threews/subdomain.js), [api/x402/pay-by-name.js](api/x402/pay-by-name.js), [src/solana/sns-subdomain.js](src/solana/sns-subdomain.js), [pages/threews-claim.html](pages/threews-claim.html) | In-repo | `*.threews.sol` subdomain mint, x402 payments addressed by name. Env: `THREEWS_SOL_PARENT_SECRET_BASE58` |diff --git a/awesome/CONTRIBUTING.md b/awesome/CONTRIBUTING.mdindex a578afa36..797d46efd 100644--- a/awesome/CONTRIBUTING.md+++ b/awesome/CONTRIBUTING.md@@ -21,10 +21,16 @@ there is overwritten by the next build. Entries live in3. Regenerate and check:```bash-npm run build:awesome # rewrites awesome/README.md and public/awesome.json-npm run awesome:links # fetches every url and reports anything unreachable+npm run build:awesome # rewrites awesome/README.md and public/awesome.json+npm run awesome:links # fetches every url and reports anything unreachable+npx awesome-lint awesome/README.md```+`awesome-lint` reports two errors that cannot be fixed from a file: it reads+the GitHub repository's topics, and this list lives inside a product repo. That+is what the mirror below exists for. Every other rule is enforced by the build,+so a green `npm run build:awesome` means a green lint.+4. Commit `data/awesome.json` together with both generated files.## What gets in@@ -36,8 +42,11 @@ The bar is "a working engineer would be glad someone showed them this".- **It has to earn its section.** Fifteen text-to-3D models that do the samething help nobody. If a new entry beats an existing one on the same job, sayso in the description, or replace the old one.-- **One sentence, under 260 characters.** Say what it does and why you would- reach for it over the alternative. The build fails on longer descriptions.+- **One sentence, under 260 characters**, starting with a capital letter and+ ending with a period. Say what it does and why you would reach for it over+ the alternative. The build fails on anything else, and so does `awesome-lint`.+ A project whose real name is lowercase (`three.js`, `gsplat`) still cannot+ open the sentence: rephrase so a capital does.- **No em-dash (U+2014) or en-dash (U+2013).** House rule across this repository.Use a period, a comma, a colon, or parentheses. A plain hyphen is fine. Thebuild fails on either dash.@@ -62,3 +71,17 @@ A new section is a bigger change than a new entry. Propose it in an issuefirst, with the three or more entries that would fill it. Sections are orderedalong the pipeline: generate, capture, embody, rig, animate, speak, render,ship, connect.++## The published mirror++The canonical [awesome.re](https://awesome.re) index only accepts a dedicated+repository, so the list is also published as a standalone mirror:++```bash+npm run awesome:standalone+```++That writes `readme.md`, `contributing.md`, `code-of-conduct.md`, and `license`+to a sibling directory and prints the `gh` commands to create the repository and+set the `awesome` and `awesome-list` topics. Nothing in that directory is+committed here; regenerate it after any change to the list and push the mirror.diff --git a/awesome/README.md b/awesome/README.mdindex fc35d71d1..d902bf648 100644--- a/awesome/README.md+++ b/awesome/README.md@@ -1,24 +1,24 @@-# Awesome 3D Agents--[](https://awesome.re)+# Awesome 3D Agents [](https://awesome.re)> Everything you need to give an AI agent a body.A curated list of the models, engines, formats, and research that turn a language model into something you can see, animate, talk to, and put on a web page. Generation, rigging, motion, faces, voice, renderers, and the agent frameworks that drive them.-134 entries across 13 sections. Browsable, searchable, and filterable at [three.ws/awesome](https://three.ws/awesome). Every link is checked with `npm run awesome:links`.+152 entries across 15 sections. Browsable, searchable, and filterable at [three.ws/awesome](https://three.ws/awesome). Every link is fetched and verified before it ships.## Contents- [Text and image to 3D](#text-and-image-to-3d) (16)- [Photos and video to 3D](#photos-and-video-to-3d) (14)-- [Avatars and characters](#avatars-and-characters) (8)-- [Rigging and retargeting](#rigging-and-retargeting) (6)-- [Motion and animation](#motion-and-animation) (9)+- [Avatars and characters](#avatars-and-characters) (13)+- [Rigging and retargeting](#rigging-and-retargeting) (8)+- [Motion and animation](#motion-and-animation) (10)+- [Texturing and materials](#texturing-and-materials) (5)- [Faces, lipsync, and voice](#faces-lipsync-and-voice) (15)- [Rendering on the web](#rendering-on-the-web) (12)- [Formats and asset pipeline](#formats-and-asset-pipeline) (12)-- [Physics, networking, and shared worlds](#physics-networking-and-shared-worlds) (9)+- [AR and XR](#ar-and-xr) (6)+- [Physics, networking, and shared worlds](#physics-networking-and-shared-worlds) (8)- [Agent frameworks and protocols](#agent-frameworks-and-protocols) (13)- [Datasets and simulators](#datasets-and-simulators) (7)- [Free assets](#free-assets) (6)@@ -76,6 +76,11 @@ Humanoid bodies that arrive already rigged, already skinned, and ready to be dri- [SMPL-X](https://smpl-x.is.tue.mpg.de) - A parametric body model with articulated hands and an expressive face. The shared coordinate system that most human motion research speaks.- [Character Creator](https://www.reallusion.com/character-creator/) - Commercial character authoring with production-grade topology, morphs, and direct export to game engines.- [three.ws Avatar Studio](https://three.ws/avatar-studio) - Generate, rig, dress, and pose an avatar in the browser, then embed it anywhere with one script tag.+- [MetaHuman](https://dev.epicgames.com/documentation/en-us/metahuman/metahuman-documentation) - Epic's photorealistic human creator, free to use, with a browser editor and export into Unreal or Maya. The quality ceiling for a digital human.+- [VRM Add-on for Blender](https://github.com/saturday06/VRM-Addon-for-Blender) - Import, edit, and export VRM avatars in Blender, including spring bones and expressions. The missing link between an authoring tool and the avatar format.+- [PIFuHD](https://github.com/facebookresearch/pifuhd) - Reconstructs a clothed 3D human from one photo at a resolution that captures fabric folds. The paper that made single-image humans plausible.+- [ECON](https://github.com/YuliangXiu/ECON) - Clothed human reconstruction that stays robust on loose garments and unusual poses, where implicit-only methods fall apart.+- [Meshcapade](https://meshcapade.com) - Commercial bodies and motion built on the SMPL family, so what you buy speaks the same parameter space as the research above.## Rigging and retargeting@@ -86,7 +91,9 @@ A mesh without a skeleton is a statue. This is the layer that decides whether an- [RigNet](https://github.com/zhan-xu/RigNet) - The neural rigging paper this field grew out of: joint prediction, skeleton connectivity, and skinning learned end to end.- [AccuRIG](https://actorcore.reallusion.com/auto-rig) - A free desktop auto-rigger for static humanoid meshes, with clean weight painting and direct export to standard skeletons.- [Rigify](https://docs.blender.org/manual/en/4.5/addons/rigging/rigify/index.html) - Blender's bundled meta-rig system. Free, scriptable, and the practical fallback when an automatic rigger gets a character wrong.-- [SkeletonUtils](https://threejs.org/docs/#examples/en/utils/SkeletonUtils) - three.js retargeting helpers that map a clip authored for one skeleton onto another at runtime. Small, unglamorous, and load-bearing.+- [SkeletonUtils](https://threejs.org/docs/#examples/en/utils/SkeletonUtils) - Retargeting helpers in three.js that map a clip authored for one skeleton onto another at runtime. Small, unglamorous, and load-bearing.+- [Ossos](https://github.com/sketchpunklabs/ossos) - A TypeScript skeletal animation library with inverse kinematics and retargeting written to be read, not just imported.+- [mixamo_converter](https://github.com/enziop/mixamo_converter) - Batch-converts Mixamo clips to in-place root motion in Blender, which is the conversion every game and web project needs and Mixamo does not do.## Motion and animation@@ -101,6 +108,17 @@ Generated motion, captured motion, and the datasets both are trained on. A body- [AMASS](https://amass.is.tue.mpg.de) - Fifteen-plus motion capture datasets unified onto one SMPL body. The reason cross-dataset motion training is possible at all.- [Cascadeur](https://cascadeur.com) - Keyframe animation software with physics-aware assistance and AutoPosing, usable free for individuals under a revenue threshold.- [Rokoko](https://www.rokoko.com) - Motion capture suits and a free video-to-motion tool, plus a Blender plugin that handles retargeting.+- [Kalidokit](https://github.com/yeemachine/kalidokit) - Turns MediaPipe face, hand, and pose landmarks into VRM rotations in the browser, so a webcam drives an avatar with no capture suit.++## Texturing and materials++Geometry is half the asset. These are the tools that decide whether it looks like a surface or like grey clay.++- [TEXTure](https://github.com/TEXTurePaper/TEXTurePaper) - Text-guided texturing of an existing mesh through iterative depth-conditioned diffusion. The paper that started this category.+- [Text2Tex](https://github.com/daveredrum/Text2Tex) - Generates high-resolution textures for a mesh from a prompt, with a view-selection pass that reduces the seams these methods usually leave.+- [Paint3D](https://github.com/OpenTexture/Paint3D) - Produces lighting-free texture maps, so the result can be relit properly instead of baking one scene's shadows into the albedo.+- [xatlas](https://github.com/jpcy/xatlas) - Mesh parameterisation and UV atlas generation. A generated mesh with no UVs cannot be textured, and this is what fixes that.+- [Material Maker](https://github.com/RodZill4/material-maker) - A free node-based procedural material authoring tool built on Godot, in the shape of Substance Designer.## Faces, lipsync, and voice@@ -127,14 +145,14 @@ The difference between a model standing there and an agent talking to you. SpeecThe runtime that actually puts the body on a page. Everything above is upstream of a choice made here.- [three.js](https://github.com/mrdoob/three.js) - The default WebGL and WebGPU library for the web, with the deepest ecosystem of loaders, controls, and examples anywhere.-- [React Three Fiber](https://github.com/pmndrs/react-three-fiber) - three.js as a React renderer. Scene graphs become components, and the reconciler handles the mutation you would otherwise write by hand.+- [React Three Fiber](https://github.com/pmndrs/react-three-fiber) - A React renderer for three.js. Scene graphs become components, and the reconciler handles the mutation you would otherwise write by hand.- [drei](https://github.com/pmndrs/drei) - The helper library that makes React Three Fiber practical: controls, loaders, staging, text, and effects you would otherwise rebuild every project.- [Babylon.js](https://github.com/BabylonJS/Babylon.js) - A batteries-included web engine with a built-in physics layer, node material editor, and an inspector that is genuinely better than the alternatives.- [PlayCanvas](https://github.com/playcanvas/engine) - A lightweight engine tuned hard for load time and mobile, backed by a collaborative browser editor.- [model-viewer](https://github.com/google/model-viewer) - One custom element that renders a glTF with sensible defaults, accessibility, and AR on both phone platforms. The lowest-effort correct answer.- [A-Frame](https://github.com/aframevr/aframe) - Declarative HTML for WebXR scenes, with an entity-component system underneath. Still the shortest path from markup to headset.-- [Threlte](https://github.com/threlte/threlte) - three.js for Svelte, with a component library, physics bindings, and a preprocessor that keeps bundles small.-- [TresJS](https://github.com/Tresjs/tres) - three.js as Vue components, with reactivity mapped onto scene-graph updates.+- [Threlte](https://github.com/threlte/threlte) - Svelte components for three.js, with a component library, physics bindings, and a preprocessor that keeps bundles small.+- [TresJS](https://github.com/Tresjs/tres) - Vue components for three.js, with reactivity mapped onto scene-graph updates.- [OGL](https://github.com/oframe/ogl) - A minimal WebGL library that stays close to the API instead of hiding it. The right tool when three.js is more engine than you need.- [Needle Engine](https://needle.tools) - Author in Unity or Blender, ship a small web build. A pragmatic bridge for teams whose content pipeline already exists.- [agent-3d](https://github.com/nirholas/three.ws/tree/main/avatar-sdk) - A web component that drops a rigged, animated, lip-syncing agent avatar onto any page in one tag, with a JS API for moods and gestures.@@ -156,6 +174,17 @@ Getting the asset small, valid, and loadable. Most 3D-on-the-web failures are pi- [OpenUSD](https://github.com/PixarAnimationStudios/OpenUSD) - Pixar's scene description for large, layered, collaboratively edited worlds. Heavier than glTF, and the right answer above a certain scale.- [three-mesh-bvh](https://github.com/gkjohnson/three-mesh-bvh) - Bounding volume hierarchies for three.js geometry, turning raycasts against dense meshes from unusable into instant.+## AR and XR++Getting the body off the page and into the room. The web is the only platform where this needs no install.++- [WebXR Device API](https://immersive-web.github.io/webxr/) - The specification behind every headset and phone AR session on the open web. Read the spec, not just a framework's wrapper.+- [WebXR Samples](https://immersive-web.github.io/webxr-samples/) - The working group's own runnable examples, from a bare session to hit testing and layers. Read these before any framework tutorial.+- [Immersive Web Emulator](https://github.com/meta-quest/immersive-web-emulator) - A browser extension that emulates a headset and controllers, so WebXR can be developed and debugged without putting a device on.+- [AR Quick Look](https://developer.apple.com/documentation/arkit/previewing-a-model-with-ar-quick-look) - Apple's system AR viewer. A USDZ behind a link opens full-screen AR on any iPhone with no app and no permission prompt.+- [Scene Viewer](https://developers.google.com/ar/develop/scene-viewer) - The Android equivalent, launched from an intent URL with a glTF. Together with AR Quick Look it is why model-viewer can offer AR everywhere.+- [8th Wall](https://8thwall.org/) - Markerless AR that runs in the mobile browser rather than an app, with world tracking and face effects.+## Physics, networking, and shared worldsOne avatar in a viewer is a demo. Several avatars in a place, with gravity and collisions, is a product.@@ -168,7 +197,6 @@ One avatar in a viewer is a demo. Several avatars in a place, with gravity and c- [LiveKit](https://github.com/livekit/livekit) - An open WebRTC server for real-time audio and video, with SDKs everywhere and a self-hostable path.- [mediasoup](https://github.com/versatica/mediasoup) - A selective forwarding unit as a Node library rather than a service, for teams that want to own the media path.- [geckos.io](https://github.com/geckosio/geckos.io) - Unreliable UDP-like messaging in the browser over WebRTC data channels, which is what fast-moving avatar positions actually want.-- [WebXR Device API](https://immersive-web.github.io/webxr/) - The specification behind every headset and phone AR session on the open web. Read the spec, not just a framework's wrapper.## Agent frameworks and protocols@@ -225,8 +253,4 @@ How to get good at this. Read in roughly this order.## Contributing-Additions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) first: entries live in [`data/awesome.json`](../data/awesome.json), not in this file, which is generated.--## License--The list is published under [Apache-2.0](../LICENSE) with the rest of this repository. Each linked project carries its own license.+Additions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) first: entries live in [`data/awesome.json`](../data/awesome.json), not in this file, which is generated. The list is published under Apache-2.0, and each linked project carries its own license.diff --git a/data/awesome.json b/data/awesome.jsonindex d992bc4f5..8c11acf71 100644--- a/data/awesome.json+++ b/data/awesome.json@@ -391,6 +391,55 @@"free","gltf"]+ },+ {+ "name": "MetaHuman",+ "url": "https://dev.epicgames.com/documentation/en-us/metahuman/metahuman-documentation",+ "description": "Epic's photorealistic human creator, free to use, with a browser editor and export into Unreal or Maya. The quality ceiling for a digital human.",+ "tags": [+ "free",+ "service"+ ]+ },+ {+ "name": "VRM Add-on for Blender",+ "url": "https://github.com/saturday06/VRM-Addon-for-Blender",+ "description": "Import, edit, and export VRM avatars in Blender, including spring bones and expressions. The missing link between an authoring tool and the avatar format.",+ "tags": [+ "oss",+ "blender",+ "vrm"+ ]+ },+ {+ "name": "PIFuHD",+ "url": "https://github.com/facebookresearch/pifuhd",+ "description": "Reconstructs a clothed 3D human from one photo at a resolution that captures fabric folds. The paper that made single-image humans plausible.",+ "tags": [+ "oss",+ "python",+ "research",+ "foundational"+ ]+ },+ {+ "name": "ECON",+ "url": "https://github.com/YuliangXiu/ECON",+ "description": "Clothed human reconstruction that stays robust on loose garments and unusual poses, where implicit-only methods fall apart.",+ "tags": [+ "oss",+ "python",+ "research"+ ]+ },+ {+ "name": "Meshcapade",+ "url": "https://meshcapade.com",+ "description": "Commercial bodies and motion built on the SMPL family, so what you buy speaks the same parameter space as the research above.",+ "tags": [+ "service",+ "api"+ ]}]},@@ -451,12 +500,32 @@{"name": "SkeletonUtils","url": "https://threejs.org/docs/#examples/en/utils/SkeletonUtils",- "description": "three.js retargeting helpers that map a clip authored for one skeleton onto another at runtime. Small, unglamorous, and load-bearing.",+ "description": "Retargeting helpers in three.js that map a clip authored for one skeleton onto another at runtime. Small, unglamorous, and load-bearing.","tags": ["oss","js","threejs"]+ },+ {+ "name": "Ossos",+ "url": "https://github.com/sketchpunklabs/ossos",+ "description": "A TypeScript skeletal animation library with inverse kinematics and retargeting written to be read, not just imported.",+ "tags": [+ "oss",+ "js",+ "ik"+ ]+ },+ {+ "name": "mixamo_converter",+ "url": "https://github.com/enziop/mixamo_converter",+ "description": "Batch-converts Mixamo clips to in-place root motion in Blender, which is the conversion every game and web project needs and Mixamo does not do.",+ "tags": [+ "oss",+ "blender",+ "animations"+ ]}]},@@ -552,6 +621,75 @@"service","mocap"]+ },+ {+ "name": "Kalidokit",+ "url": "https://github.com/yeemachine/kalidokit",+ "description": "Turns MediaPipe face, hand, and pose landmarks into VRM rotations in the browser, so a webcam drives an avatar with no capture suit.",+ "tags": [+ "oss",+ "js",+ "vrm",+ "tracking"+ ]+ }+ ]+ },+ {+ "id": "texturing",+ "title": "Texturing and materials",+ "description": "Geometry is half the asset. These are the tools that decide whether it looks like a surface or like grey clay.",+ "items": [+ {+ "name": "TEXTure",+ "url": "https://github.com/TEXTurePaper/TEXTurePaper",+ "description": "Text-guided texturing of an existing mesh through iterative depth-conditioned diffusion. The paper that started this category.",+ "tags": [+ "oss",+ "python",+ "research",+ "foundational"+ ]+ },+ {+ "name": "Text2Tex",+ "url": "https://github.com/daveredrum/Text2Tex",+ "description": "Generates high-resolution textures for a mesh from a prompt, with a view-selection pass that reduces the seams these methods usually leave.",+ "tags": [+ "oss",+ "python",+ "research"+ ]+ },+ {+ "name": "Paint3D",+ "url": "https://github.com/OpenTexture/Paint3D",+ "description": "Produces lighting-free texture maps, so the result can be relit properly instead of baking one scene's shadows into the albedo.",+ "tags": [+ "oss",+ "python",+ "pbr"+ ]+ },+ {+ "name": "xatlas",+ "url": "https://github.com/jpcy/xatlas",+ "description": "Mesh parameterisation and UV atlas generation. A generated mesh with no UVs cannot be textured, and this is what fixes that.",+ "tags": [+ "oss",+ "cpp",+ "foundational"+ ]+ },+ {+ "name": "Material Maker",+ "url": "https://github.com/RodZill4/material-maker",+ "description": "A free node-based procedural material authoring tool built on Godot, in the shape of Substance Designer.",+ "tags": [+ "oss",+ "free",+ "gui"+ ]}]},@@ -734,7 +872,7 @@{"name": "React Three Fiber","url": "https://github.com/pmndrs/react-three-fiber",- "description": "three.js as a React renderer. Scene graphs become components, and the reconciler handles the mutation you would otherwise write by hand.",+ "description": "A React renderer for three.js. Scene graphs become components, and the reconciler handles the mutation you would otherwise write by hand.","tags": ["oss","js",@@ -796,7 +934,7 @@{"name": "Threlte","url": "https://github.com/threlte/threlte",- "description": "three.js for Svelte, with a component library, physics bindings, and a preprocessor that keeps bundles small.",+ "description": "Svelte components for three.js, with a component library, physics bindings, and a preprocessor that keeps bundles small.","tags": ["oss","js",@@ -806,7 +944,7 @@{"name": "TresJS","url": "https://github.com/Tresjs/tres",- "description": "three.js as Vue components, with reactivity mapped onto scene-graph updates.",+ "description": "Vue components for three.js, with reactivity mapped onto scene-graph updates.","tags": ["oss","js",@@ -975,6 +1113,71 @@}]},+ {+ "id": "xr",+ "title": "AR and XR",+ "description": "Getting the body off the page and into the room. The web is the only platform where this needs no install.",+ "items": [+ {+ "name": "WebXR Device API",+ "url": "https://immersive-web.github.io/webxr/",+ "description": "The specification behind every headset and phone AR session on the open web. Read the spec, not just a framework's wrapper.",+ "tags": [+ "spec",+ "webxr"+ ]+ },+ {+ "name": "WebXR Samples",+ "url": "https://immersive-web.github.io/webxr-samples/",+ "description": "The working group's own runnable examples, from a bare session to hit testing and layers. Read these before any framework tutorial.",+ "tags": [+ "free",+ "webxr",+ "reference"+ ]+ },+ {+ "name": "Immersive Web Emulator",+ "url": "https://github.com/meta-quest/immersive-web-emulator",+ "description": "A browser extension that emulates a headset and controllers, so WebXR can be developed and debugged without putting a device on.",+ "tags": [+ "oss",+ "webxr",+ "tooling"+ ]+ },+ {+ "name": "AR Quick Look",+ "url": "https://developer.apple.com/documentation/arkit/previewing-a-model-with-ar-quick-look",+ "description": "Apple's system AR viewer. A USDZ behind a link opens full-screen AR on any iPhone with no app and no permission prompt.",+ "tags": [+ "spec",+ "ar",+ "ios"+ ]+ },+ {+ "name": "Scene Viewer",+ "url": "https://developers.google.com/ar/develop/scene-viewer",+ "description": "The Android equivalent, launched from an intent URL with a glTF. Together with AR Quick Look it is why model-viewer can offer AR everywhere.",+ "tags": [+ "spec",+ "ar",+ "android"+ ]+ },+ {+ "name": "8th Wall",+ "url": "https://8thwall.org/",+ "description": "Markerless AR that runs in the mobile browser rather than an app, with world tracking and face effects.",+ "tags": [+ "service",+ "ar"+ ]+ }+ ]+ },{"id": "worlds","title": "Physics, networking, and shared worlds",@@ -1062,15 +1265,6 @@"js","networking"]- },- {- "name": "WebXR Device API",- "url": "https://immersive-web.github.io/webxr/",- "description": "The specification behind every headset and phone AR session on the open web. Read the spec, not just a framework's wrapper.",- "tags": [- "spec",- "webxr"- ]}]},diff --git a/data/changelog.json b/data/changelog.jsonindex d664d4b16..8658e25e9 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -18,7 +18,7 @@{"date": "2026-09-07","title": "Awesome 3D Agents: a curated list of everything you need to give an AI a body",- "summary": "Giving an agent a body means assembling a pipeline out of a dozen separate fields, and the map of that pipeline did not exist anywhere. There is now one: 134 hand-picked projects across 13 sections, covering text-to-3D generation, photo and video capture, avatars, rigging, motion generation, lipsync and voice, web renderers, asset pipelines, physics and networking, agent frameworks, datasets, free assets, and where to learn all of it. Each entry says in one sentence what the thing does and why you would reach for it instead of the alternative. The list is searchable and filterable by tag at /awesome, copyable as Markdown, and published in the standard awesome-list format on GitHub so it can be read, forked, and contributed to there. Every link is fetched and verified before it ships.",+ "summary": "Giving an agent a body means assembling a pipeline out of a dozen separate fields, and the map of that pipeline did not exist anywhere. There is now one: 152 hand-picked projects across 15 sections, covering text-to-3D generation, photo and video capture, avatars, rigging, motion generation, texturing, lipsync and voice, web renderers, asset pipelines, AR and XR, physics and networking, agent frameworks, datasets, free assets, and where to learn all of it. Each entry says in one sentence what the thing does and why you would reach for it instead of the alternative. The list is searchable and filterable by tag at /awesome, copyable as Markdown, and published in the standard awesome-list format on GitHub so it can be read, forked, and contributed to there. Every link is fetched and verified before it ships.","tags": ["feature", "docs"],"link": "/awesome"},diff --git a/package.json b/package.jsonindex f2964b3de..0f4cf410a 100644--- a/package.json+++ b/package.json@@ -459,7 +459,8 @@"deck:inception": "node scripts/build-inception-deck.mjs","build:awesome": "node scripts/build-awesome.mjs","check:awesome": "node scripts/build-awesome.mjs --check",- "awesome:links": "node scripts/check-awesome-links.mjs"+ "awesome:links": "node scripts/check-awesome-links.mjs",+ "awesome:standalone": "node scripts/build-awesome.mjs --standalone"},"dependencies": {"@0xsplits/splits-sdk": "^6.5.0",diff --git a/public/awesome.json b/public/awesome.jsonindex 24e4f660c..2f5ed3bcd 100644--- a/public/awesome.json+++ b/public/awesome.json@@ -5,46 +5,46 @@"repo": "https://github.com/nirholas/three.ws/tree/main/awesome","markdown": "https://github.com/nirholas/three.ws/blob/main/awesome/README.md","counts": {- "items": 134,- "sections": 13,- "tags": 92+ "items": 152,+ "sections": 15,+ "tags": 97},"tags": [{"id": "oss",- "count": 88+ "count": 100},{"id": "python",- "count": 40+ "count": 45},{"id": "js",- "count": 29+ "count": 31},{"id": "free",- "count": 21+ "count": 24},{"id": "research",- "count": 20+ "count": 24},{"id": "foundational",- "count": 15+ "count": 18},{"id": "service",- "count": 11+ "count": 14},{- "id": "cpp",- "count": 8+ "id": "spec",+ "count": 10},{- "id": "spec",- "count": 8+ "id": "cpp",+ "count": 9},{"id": "dataset",@@ -54,6 +54,10 @@"id": "threejs","count": 6},+ {+ "id": "ar",+ "count": 4+ },{"id": "cc0","count": 4@@ -78,6 +82,22 @@"id": "tts","count": 4},+ {+ "id": "vrm",+ "count": 4+ },+ {+ "id": "webxr",+ "count": 4+ },+ {+ "id": "api",+ "count": 3+ },+ {+ "id": "blender",+ "count": 3+ },{"id": "compression","count": 3@@ -98,6 +118,10 @@"id": "physics","count": 3},+ {+ "id": "reference",+ "count": 3+ },{"id": "stt","count": 3@@ -107,7 +131,7 @@"count": 3},{- "id": "api",+ "id": "animations","count": 2},{@@ -126,6 +150,10 @@"id": "engine","count": 2},+ {+ "id": "gui",+ "count": 2+ },{"id": "hosted","count": 2@@ -154,10 +182,6 @@"id": "realtime","count": 2},- {- "id": "reference",- "count": 2- },{"id": "rust","count": 2@@ -175,7 +199,7 @@"count": 2},{- "id": "vrm",+ "id": "tracking","count": 2},{@@ -189,10 +213,6 @@{"id": "webgpu","count": 2- },- {- "id": "webxr",- "count": 2}],"sections": [@@ -580,6 +600,55 @@"free","gltf"]+ },+ {+ "name": "MetaHuman",+ "url": "https://dev.epicgames.com/documentation/en-us/metahuman/metahuman-documentation",+ "description": "Epic's photorealistic human creator, free to use, with a browser editor and export into Unreal or Maya. The quality ceiling for a digital human.",+ "tags": [+ "free",+ "service"+ ]+ },+ {+ "name": "VRM Add-on for Blender",+ "url": "https://github.com/saturday06/VRM-Addon-for-Blender",+ "description": "Import, edit, and export VRM avatars in Blender, including spring bones and expressions. The missing link between an authoring tool and the avatar format.",+ "tags": [+ "oss",+ "blender",+ "vrm"+ ]+ },+ {+ "name": "PIFuHD",+ "url": "https://github.com/facebookresearch/pifuhd",+ "description": "Reconstructs a clothed 3D human from one photo at a resolution that captures fabric folds. The paper that made single-image humans plausible.",+ "tags": [+ "oss",+ "python",+ "research",+ "foundational"+ ]+ },+ {+ "name": "ECON",+ "url": "https://github.com/YuliangXiu/ECON",+ "description": "Clothed human reconstruction that stays robust on loose garments and unusual poses, where implicit-only methods fall apart.",+ "tags": [+ "oss",+ "python",+ "research"+ ]+ },+ {+ "name": "Meshcapade",+ "url": "https://meshcapade.com",+ "description": "Commercial bodies and motion built on the SMPL family, so what you buy speaks the same parameter space as the research above.",+ "tags": [+ "service",+ "api"+ ]}]},@@ -640,12 +709,32 @@{"name": "SkeletonUtils","url": "https://threejs.org/docs/#examples/en/utils/SkeletonUtils",- "description": "three.js retargeting helpers that map a clip authored for one skeleton onto another at runtime. Small, unglamorous, and load-bearing.",+ "description": "Retargeting helpers in three.js that map a clip authored for one skeleton onto another at runtime. Small, unglamorous, and load-bearing.","tags": ["oss","js","threejs"]+ },+ {+ "name": "Ossos",+ "url": "https://github.com/sketchpunklabs/ossos",+ "description": "A TypeScript skeletal animation library with inverse kinematics and retargeting written to be read, not just imported.",+ "tags": [+ "oss",+ "js",+ "ik"+ ]+ },+ {+ "name": "mixamo_converter",+ "url": "https://github.com/enziop/mixamo_converter",+ "description": "Batch-converts Mixamo clips to in-place root motion in Blender, which is the conversion every game and web project needs and Mixamo does not do.",+ "tags": [+ "oss",+ "blender",+ "animations"+ ]}]},@@ -741,6 +830,75 @@"service","mocap"]+ },+ {+ "name": "Kalidokit",+ "url": "https://github.com/yeemachine/kalidokit",+ "description": "Turns MediaPipe face, hand, and pose landmarks into VRM rotations in the browser, so a webcam drives an avatar with no capture suit.",+ "tags": [+ "oss",+ "js",+ "vrm",+ "tracking"+ ]+ }+ ]+ },+ {+ "id": "texturing",+ "title": "Texturing and materials",+ "description": "Geometry is half the asset. These are the tools that decide whether it looks like a surface or like grey clay.",+ "items": [+ {+ "name": "TEXTure",+ "url": "https://github.com/TEXTurePaper/TEXTurePaper",+ "description": "Text-guided texturing of an existing mesh through iterative depth-conditioned diffusion. The paper that started this category.",+ "tags": [+ "oss",+ "python",+ "research",+ "foundational"+ ]+ },+ {+ "name": "Text2Tex",+ "url": "https://github.com/daveredrum/Text2Tex",+ "description": "Generates high-resolution textures for a mesh from a prompt, with a view-selection pass that reduces the seams these methods usually leave.",+ "tags": [+ "oss",+ "python",+ "research"+ ]+ },+ {+ "name": "Paint3D",+ "url": "https://github.com/OpenTexture/Paint3D",+ "description": "Produces lighting-free texture maps, so the result can be relit properly instead of baking one scene's shadows into the albedo.",+ "tags": [+ "oss",+ "python",+ "pbr"+ ]+ },+ {+ "name": "xatlas",+ "url": "https://github.com/jpcy/xatlas",+ "description": "Mesh parameterisation and UV atlas generation. A generated mesh with no UVs cannot be textured, and this is what fixes that.",+ "tags": [+ "oss",+ "cpp",+ "foundational"+ ]+ },+ {+ "name": "Material Maker",+ "url": "https://github.com/RodZill4/material-maker",+ "description": "A free node-based procedural material authoring tool built on Godot, in the shape of Substance Designer.",+ "tags": [+ "oss",+ "free",+ "gui"+ ]}]},@@ -923,7 +1081,7 @@{"name": "React Three Fiber","url": "https://github.com/pmndrs/react-three-fiber",- "description": "three.js as a React renderer. Scene graphs become components, and the reconciler handles the mutation you would otherwise write by hand.",+ "description": "A React renderer for three.js. Scene graphs become components, and the reconciler handles the mutation you would otherwise write by hand.","tags": ["oss","js",@@ -985,7 +1143,7 @@{"name": "Threlte","url": "https://github.com/threlte/threlte",- "description": "three.js for Svelte, with a component library, physics bindings, and a preprocessor that keeps bundles small.",+ "description": "Svelte components for three.js, with a component library, physics bindings, and a preprocessor that keeps bundles small.","tags": ["oss","js",@@ -995,7 +1153,7 @@{"name": "TresJS","url": "https://github.com/Tresjs/tres",- "description": "three.js as Vue components, with reactivity mapped onto scene-graph updates.",+ "description": "Vue components for three.js, with reactivity mapped onto scene-graph updates.","tags": ["oss","js",@@ -1164,6 +1322,71 @@}]},+ {+ "id": "xr",+ "title": "AR and XR",+ "description": "Getting the body off the page and into the room. The web is the only platform where this needs no install.",+ "items": [+ {+ "name": "WebXR Device API",+ "url": "https://immersive-web.github.io/webxr/",+ "description": "The specification behind every headset and phone AR session on the open web. Read the spec, not just a framework's wrapper.",+ "tags": [+ "spec",+ "webxr"+ ]+ },+ {+ "name": "WebXR Samples",+ "url": "https://immersive-web.github.io/webxr-samples/",+ "description": "The working group's own runnable examples, from a bare session to hit testing and layers. Read these before any framework tutorial.",+ "tags": [+ "free",+ "webxr",+ "reference"+ ]+ },+ {+ "name": "Immersive Web Emulator",+ "url": "https://github.com/meta-quest/immersive-web-emulator",+ "description": "A browser extension that emulates a headset and controllers, so WebXR can be developed and debugged without putting a device on.",+ "tags": [+ "oss",+ "webxr",+ "tooling"+ ]+ },+ {+ "name": "AR Quick Look",+ "url": "https://developer.apple.com/documentation/arkit/previewing-a-model-with-ar-quick-look",+ "description": "Apple's system AR viewer. A USDZ behind a link opens full-screen AR on any iPhone with no app and no permission prompt.",+ "tags": [+ "spec",+ "ar",+ "ios"+ ]+ },+ {+ "name": "Scene Viewer",+ "url": "https://developers.google.com/ar/develop/scene-viewer",+ "description": "The Android equivalent, launched from an intent URL with a glTF. Together with AR Quick Look it is why model-viewer can offer AR everywhere.",+ "tags": [+ "spec",+ "ar",+ "android"+ ]+ },+ {+ "name": "8th Wall",+ "url": "https://8thwall.org/",+ "description": "Markerless AR that runs in the mobile browser rather than an app, with world tracking and face effects.",+ "tags": [+ "service",+ "ar"+ ]+ }+ ]+ },{"id": "worlds","title": "Physics, networking, and shared worlds",@@ -1251,15 +1474,6 @@"js","networking"]- },- {- "name": "WebXR Device API",- "url": "https://immersive-web.github.io/webxr/",- "description": "The specification behind every headset and phone AR session on the open web. Read the spec, not just a framework's wrapper.",- "tags": [- "spec",- "webxr"- ]}]},diff --git a/scripts/build-awesome.mjs b/scripts/build-awesome.mjsindex 508db7e03..2de97f1f0 100644--- a/scripts/build-awesome.mjs+++ b/scripts/build-awesome.mjs@@ -7,8 +7,17 @@* awesome/README.md the list, in the awesome-list format people expect* public/awesome.json the same data plus counts and a tag index, for /awesome*- * node scripts/build-awesome.mjs write both- * node scripts/build-awesome.mjs --check fail if either is out of date+ * node scripts/build-awesome.mjs write both+ * node scripts/build-awesome.mjs --check fail if either is out of date+ * node scripts/build-awesome.mjs --standalone emit a publishable mirror repo+ *+ * The --standalone mode exists because awesome-lint's awesome-github rule is+ * satisfied by repository topics, not by file content: a list living in a+ * subdirectory of a product repo can never pass it, and so can never be+ * submitted to the awesome.re index. It writes a self-describing mirror repo+ * (readme, contributing, code of conduct, license) to --out, defaulting to a+ * sibling of this checkout, and prints the commands to publish it. Nothing in+ * that directory is committed here.** The --check mode runs in `npm run gate`, so an edit to the data that never* got built cannot ship a stale README.@@ -18,7 +27,13 @@ import path from 'node:path';import { fileURLToPath } from 'node:url';const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');-const check = process.argv.includes('--check');+const argv = process.argv.slice(2);+const check = argv.includes('--check');+const standalone = argv.includes('--standalone');+const outFlag = (() => {+ const i = argv.indexOf('--out');+ return i === -1 ? null : argv[i + 1];+})();const list = JSON.parse(readFileSync(path.join(root, 'data/awesome.json'), 'utf8'));@@ -31,17 +46,31 @@ for (const section of list.sections) {if (!section.items.length) problems.push(`empty section: ${section.id}`);for (const item of section.items) {for (const field of ['name', 'url', 'description']) {- if (!item[field]) problems.push(`${section.id}/${item.name ?? '?'} is missing ${field}`);+ if (!item[field])+ problems.push(`${section.id}/${item.name ?? '?'} is missing ${field}`);}- if (item.url && !/^https?:\/\//.test(item.url)) problems.push(`${item.name}: url must be absolute`);+ if (item.url && !/^https?:\/\//.test(item.url))+ problems.push(`${item.name}: url must be absolute`);// The awesome format renders one sentence per entry. A description that// runs past this reads as a paragraph in a list and breaks the scan.if (item.description && item.description.length > 260) {- problems.push(`${item.name}: description is ${item.description.length} chars, keep it under 260`);+ problems.push(+ `${item.name}: description is ${item.description.length} chars, keep it under 260`,+ );}if (/[\u2014\u2013]/.test(`${item.name}${item.description}`)) {problems.push(`${item.name}: uses a dash character that is banned in this repo`);}+ // awesome-lint's awesome-list-item rule, enforced here so a contribution+ // cannot break eligibility for the awesome.re index without failing first.+ if (item.description && !/^[A-Z0-9"'`]/.test(item.description)) {+ problems.push(+ `${item.name}: description must start with a capital, so "${item.description.slice(0, 24)}..." needs rephrasing`,+ );+ }+ if (item.description && !/[.!?]$/.test(item.description)) {+ problems.push(`${item.name}: description must end with a period`);+ }const key = item.url?.replace(/\/+$/, '').toLowerCase();if (key && urls.has(key)) problems.push(`${item.name} repeats the url of ${urls.get(key)}`);else if (key) urls.set(key, item.name);@@ -62,48 +91,48 @@ const anchor = (title) =>.trim().replace(/\s+/g, '-');-const md = [];-md.push(`# ${list.title}`);-md.push('');-md.push('[](https://awesome.re)');-md.push('');-md.push(`> ${list.tagline}`);-md.push('');-md.push(list.intro);-md.push('');-md.push(- `${total} entries across ${list.sections.length} sections. Browsable, searchable, and filterable at [${list.page.replace(/^https?:\/\//, '')}](${list.page}). Every link is checked with \`npm run awesome:links\`.`,-);-md.push('');-md.push('## Contents');-md.push('');-for (const section of list.sections) {- md.push(`- [${section.title}](#${anchor(section.title)}) (${section.items.length})`);-}-md.push('');-for (const section of list.sections) {- md.push(`## ${section.title}`);+// `mirror` retargets the two relative links that only resolve inside this+// repository, so the standalone copy has no dead links.+function renderReadme({ mirror }) {+ const md = [];+ // awesome-lint requires the badge on the heading line itself, and the exact+ // badge.svg asset. Anything else fails remark-lint:awesome-badge.+ md.push(`# ${list.title} [](https://awesome.re)`);md.push('');- md.push(section.description);+ md.push(`> ${list.tagline}`);md.push('');- for (const item of section.items) {- md.push(`- [${item.name}](${item.url}) - ${item.description}`);+ md.push(list.intro);+ md.push('');+ md.push(+ `${total} entries across ${list.sections.length} sections. Browsable, searchable, and filterable at [${list.page.replace(/^https?:\/\//, '')}](${list.page}). Every link is fetched and verified before it ships.`,+ );+ md.push('');+ md.push('## Contents');+ md.push('');+ for (const section of list.sections) {+ md.push(`- [${section.title}](#${anchor(section.title)}) (${section.items.length})`);}md.push('');+ for (const section of list.sections) {+ md.push(`## ${section.title}`);+ md.push('');+ md.push(section.description);+ md.push('');+ for (const item of section.items) {+ md.push(`- [${item.name}](${item.url}) - ${item.description}`);+ }+ md.push('');+ }+ md.push('## Contributing');+ md.push('');+ md.push(+ `Additions are welcome. Read [CONTRIBUTING.md](${mirror ? 'contributing.md' : 'CONTRIBUTING.md'}) first: entries live in [\`data/awesome.json\`](${mirror ? `${list.repo}/blob/main/data/awesome.json` : '../data/awesome.json'}), not in this file, which is generated. The list is published under Apache-2.0, and each linked project carries its own license.`,+ );+ md.push('');+ return md.join('\n');}-md.push('## Contributing');-md.push('');-md.push(- 'Additions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) first: entries live in [`data/awesome.json`](../data/awesome.json), not in this file, which is generated.',-);-md.push('');-md.push('## License');-md.push('');-md.push(- 'The list is published under [Apache-2.0](../LICENSE) with the rest of this repository. Each linked project carries its own license.',-);-md.push('');-const readme = md.join('\n');++const readme = renderReadme({ mirror: false });// ── public/awesome.json ──────────────────────────────────────────────────────const tagCounts = new Map();@@ -139,6 +168,82 @@ const outputs = [{ file: path.join(root, 'public/awesome.json'), content: json },];+// ── standalone mirror repo ───────────────────────────────────────────────────+// awesome-lint's awesome-github rule reads the repository's topics, so a list+// inside a product repo fails it no matter how the file is written. This emits+// the publishable mirror: a directory that is already a valid awesome list, so+// creating the repo is a copy and a push rather than a rewrite.+if (standalone) {+ const out = path.resolve(outFlag ?? path.join(root, '..', list.slug));+ const files = [+ { name: 'readme.md', content: renderReadme({ mirror: true }) },+ {+ name: 'contributing.md',+ content: [+ '# Contributing',+ '',+ `This repository is a published mirror. \`readme.md\` is generated, so an edit made here is overwritten by the next build.`,+ '',+ '## Add an entry',+ '',+ `Open a pull request against [\`data/awesome.json\`](${list.repo}/blob/main/data/awesome.json) in the source repository. Add an object to the section it belongs in:`,+ '',+ '```json',+ '{',+ ' "name": "glTF-Transform",',+ ' "url": "https://github.com/donmccurdy/glTF-Transform",',+ ' "description": "Read, edit, optimise, and validate glTF from Node or the CLI.",',+ ' "tags": ["oss", "js", "cli"]',+ '}',+ '```',+ '',+ '## What gets in',+ '',+ 'The bar is "a working engineer would be glad someone showed them this".',+ '',+ '- **It has to be usable now.** A repo with no release, no docs, and no commits in two years is a bookmark, not a recommendation.',+ '- **It has to earn its section.** If a new entry beats an existing one at the same job, say so in the description, or replace the old one.',+ '- **One sentence, under 260 characters**, starting with a capital and ending with a period. The build fails otherwise, and so does `awesome-lint`.',+ '- **No em-dash (U+2014) or en-dash (U+2013).** Use a period, a comma, a colon, or parentheses. A plain hyphen is fine.',+ '- **No marketing copy.** "Blazing fast next-generation platform" tells a reader nothing. "Single image to 3D in under a second on one GPU" does.',+ '- **Working links only.** Every url is fetched and classified as ok, moved, bot-filtered, or broken before a change ships. A broken url fails the run.',+ '',+ '## Code of conduct',+ '',+ 'By participating you agree to the [code of conduct](code-of-conduct.md).',+ '',+ ].join('\n'),+ },+ ];++ // The code of conduct and license are the repository's own, copied rather+ // than reworded so the mirror cannot drift from the terms it inherits.+ for (const [source, name] of [+ ['CODE_OF_CONDUCT.md', 'code-of-conduct.md'],+ ['LICENSE', 'license'],+ ]) {+ files.push({ name, content: readFileSync(path.join(root, source), 'utf8') });+ }++ mkdirSync(out, { recursive: true });+ for (const file of files) {+ writeFileSync(path.join(out, file.name), file.content);+ console.log(`[build-awesome] wrote ${path.join(out, file.name)}`);+ }+ console.log(`\n[build-awesome] mirror ready: ${total} entries, ${files.length} files.`);+ console.log('Publish it with:\n');+ console.log(` cd ${out}`);+ console.log(' git init -b main && git add -A');+ console.log(` git commit -m "${list.title}: ${total} curated entries"`);+ console.log(` gh repo create ${list.slug} --public --source=. --push \\`);+ console.log(` --description ${JSON.stringify(list.tagline)}`);+ console.log(` gh repo edit --add-topic awesome --add-topic awesome-list \\`);+ console.log(' --add-topic 3d --add-topic ai-agents --add-topic avatars');+ console.log('\nThe two topics are what awesome-lint checks; without them the list');+ console.log('cannot be submitted to the awesome.re index.');+ process.exit(0);+}+if (check) {const stale = outputs.filter((o) => {try {@@ -148,7 +253,8 @@ if (check) {}});if (stale.length) {- for (const o of stale) console.error(`[build-awesome] out of date: ${path.relative(root, o.file)}`);+ for (const o of stale)+ console.error(`[build-awesome] out of date: ${path.relative(root, o.file)}`);console.error('[build-awesome] run `npm run build:awesome`');process.exit(1);}diff --git a/scripts/check-awesome-links.mjs b/scripts/check-awesome-links.mjsindex cb2627761..2ad7eed62 100644--- a/scripts/check-awesome-links.mjs+++ b/scripts/check-awesome-links.mjs@@ -98,11 +98,22 @@ await Promise.all(Array.from({ length: Math.min(concurrency, targets.length) },// Compare without the fragment: an anchor into a single-page docs site is// resolved in the browser, so the server answering the bare page is correct.-const normalise = (u) =>- u- .replace(/#.*$/, '')- .replace(/\/+$/, '')- .replace(/^https?:\/\/www\./, 'https://');+// Locale parameters are dropped too, because a docs host that geolocates this+// machine and appends `?hl=zh-tw` has not moved the page anywhere.+const LOCALE_PARAMS = new Set(['hl', 'lang', 'locale', 'lr', 'gl']);+const normalise = (u) => {+ let out = u.replace(/#.*$/, '');+ try {+ const parsed = new URL(out);+ for (const key of [...parsed.searchParams.keys()]) {+ if (LOCALE_PARAMS.has(key)) parsed.searchParams.delete(key);+ }+ out = parsed.toString();+ } catch {+ // A url this malformed is already reported by the fetch itself.+ }+ return out.replace(/\?$/, '').replace(/\/+$/, '').replace(/^https?:\/\/www\./, 'https://');+};const blockedCodes = new Set([403, 429]);const broken = results.filter((r) => r.status === 0 || (r.status >= 400 && !blockedCodes.has(r.status)));diff --git a/tests/awesome-list.test.js b/tests/awesome-list.test.jsindex bd46742df..ff226e74d 100644--- a/tests/awesome-list.test.js+++ b/tests/awesome-list.test.js@@ -45,6 +45,15 @@ describe('Awesome 3D Agents source', () => {}});+ it('writes descriptions the way awesome-lint requires: capitalised, and ended', () => {+ for (const item of allItems) {+ expect(item.description[0], `${item.name} starts lowercase`).toBe(+ item.description[0].toUpperCase(),+ );+ expect(item.description.endsWith('.'), `${item.name} has no closing period`).toBe(true);+ }+ });+it('honours the repository-wide ban on em-dash and en-dash characters', () => {const banned = /[\u2014\u2013]/;for (const item of allItems) {@@ -101,7 +110,21 @@ describe('Awesome 3D Agents generated outputs', () => {for (const item of allItems) {expect(readme, `${item.name} in README`).toContain(`- [${item.name}](${item.url}) - `);}- expect(readme).toContain('[](https://awesome.re)');+ // awesome-lint's awesome-badge rule wants this exact asset, on the+ // heading line. A cosmetic change here silently ends eligibility for the+ // awesome.re index, so it is pinned.+ expect(readme.split('\n')[0]).toBe(+ '# Awesome 3D Agents [](https://awesome.re)',+ );+ });++ it('keeps the sections awesome-lint forbids out of the README', () => {+ // awesome-lint's awesome-license rule rejects a License section outright;+ // the license belongs in a license file.+ expect(readme).not.toContain('\n## License');+ // Its awesome-toc rule rejects Contributing appearing in the contents.+ const contents = readme.slice(readme.indexOf('## Contents'), readme.indexOf('\n## ', readme.indexOf('## Contents') + 5));+ expect(contents).not.toContain('- [Contributing]');});it('lists every section in the README contents', () => {