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.

feat(hubs): add awesome-embodied-agents, a verified 78-entry directory of AI avatar, digital human, VRM/glTF and web 3D runtime projects

nirholasb0fd03b387b8
diff --git a/hubs/awesome-embodied-agents/.github/ISSUE_TEMPLATE/add-project.md b/hubs/awesome-embodied-agents/.github/ISSUE_TEMPLATE/add-project.md
new file mode 100644
index 000000000..3d17ef65e
--- /dev/null
+++ b/hubs/awesome-embodied-agents/.github/ISSUE_TEMPLATE/add-project.md
@@ -0,0 +1,18 @@
+---
+name: Add a project
+about: Suggest an embodied-agent or 3D-avatar project for the directory
+title: "Add: <project name>"
+labels: add-project
+---
+
+**Name:**
+
+**Home page URL:**
+
+**Repository URL (or "closed source"):**
+
+**Category** (see `data/categories.json`):
+
+**One-sentence description (160 characters or fewer):**
+
+**Status** (active, early or archived):
diff --git a/hubs/awesome-embodied-agents/.github/PULL_REQUEST_TEMPLATE.md b/hubs/awesome-embodied-agents/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 000000000..e5e3acb80
--- /dev/null
+++ b/hubs/awesome-embodied-agents/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,11 @@
+## Project
+
+Name and link:
+
+## Checklist
+
+- [ ] I added the entry to `data/entries.json`, alphabetically within its category
+- [ ] `node scripts/validate.mjs` passes
+- [ ] I ran `node scripts/build-readme.mjs` and committed the updated `README.md`
+- [ ] The description is one factual sentence of 160 characters or fewer
+- [ ] The URL and repository are live
diff --git a/hubs/awesome-embodied-agents/CONTRIBUTING.md b/hubs/awesome-embodied-agents/CONTRIBUTING.md
new file mode 100644
index 000000000..77228c1ad
--- /dev/null
+++ b/hubs/awesome-embodied-agents/CONTRIBUTING.md
@@ -0,0 +1,48 @@
+# Contributing
+
+Thanks for helping map the embodied-agent and 3D-avatar ecosystem. Every project that makes it easier to give an AI a body, a face or a voice belongs here.
+
+## Add a project
+
+1. Fork the repository.
+2. Add one object to `data/entries.json`, placed alphabetically by `name` inside its category:
+
+ ```json
+ {
+ "id": "my-project",
+ "name": "My Project",
+ "url": "https://example.com",
+ "repo": "https://github.com/you/my-project",
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "One factual sentence about what it does, 160 characters at most.",
+ "status": "active",
+ "added": "2026-10-10"
+ }
+ ```
+
+3. Run `npm run validate` (or `node scripts/validate.mjs`). Fix anything it reports.
+4. Run `npm run build` (or `node scripts/build-readme.mjs`) and commit the regenerated `README.md`. Never edit the tables between the `ENTRIES` markers by hand.
+5. Open a pull request using the template.
+
+You can also [open an issue](.github/ISSUE_TEMPLATE/add-project.md) and a maintainer will add it.
+
+## Field rules
+
+- `id`: kebab-case, unique.
+- `url`: the project home page. `repo`: the source repository, or `null` for closed-source products.
+- `category`: an `id` from `data/categories.json`. Pick the closest fit.
+- `chain`: `none` unless the project is onchain, then the chain name (for example `solana`).
+- `description`: one factual sentence, plain language, 160 characters or fewer. Say what it does, not how great it is. No em-dashes or en-dashes.
+- `status`: `active` (maintained), `early` (new or experimental), `archived` (read-only or unmaintained but still useful).
+- `added`: the date you add it, `YYYY-MM-DD`.
+
+## What belongs
+
+- Real, working projects you can open today: libraries, tools, models, standards, platforms and datasets that help build agents with an embodied presence.
+- Open-source projects and commercial products are both welcome. Keep the tone neutral.
+- Each project is listed once. Self-listing is fine.
+
+## Review checklist
+
+Maintainers check that the URL resolves, the description matches what the project says about itself, the category fits and the file passes validation.
diff --git a/hubs/awesome-embodied-agents/LICENSE b/hubs/awesome-embodied-agents/LICENSE
new file mode 100644
index 000000000..0ee2af2ed
--- /dev/null
+++ b/hubs/awesome-embodied-agents/LICENSE
@@ -0,0 +1,122 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+ CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+ LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+ ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+ INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+ REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+ PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+ THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+ HEREUNDER.
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without fear
+of later claims of infringement build upon, modify, incorporate in other
+works, reuse and redistribute as freely as possible in any form whatsoever
+and for any purposes, including without limitation commercial purposes.
+These owners may contribute to the Commons to promote the ideal of a free
+culture and the further production of creative, cultural and scientific
+works, or to gain reputation or greater distribution for their Work in
+part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under its
+terms, with knowledge of his or her Copyright and Related Rights in the
+Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not
+limited to, the following:
+
+ i. the right to reproduce, adapt, distribute, perform, display,
+ communicate, and translate a Work;
+ ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or
+ likeness depicted in a Work;
+ iv. rights protecting against unfair competition in regards to a Work,
+ subject to the limitations in paragraph 4(a), below;
+ v. rights protecting the extraction, dissemination, use and reuse of data
+ in a Work;
+ vi. database rights (such as those arising under Directive 96/9/EC of the
+ European Parliament and of the Council of 11 March 1996 on the legal
+ protection of databases, and under any national implementation
+ thereof, including any amended or successor version of such
+ directive); and
+vii. other similar, equivalent or corresponding rights throughout the
+ world based on applicable law or treaty, and any national
+ implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+of, applicable law, Affirmer hereby overtly, fully, permanently,
+irrevocably and unconditionally waives, abandons, and surrenders all of
+Affirmer's Copyright and Related Rights and associated claims and causes
+of action, whether now known or unknown (including existing as well as
+future claims and causes of action), in the Work (i) in all territories
+worldwide, (ii) for the maximum duration provided by applicable law or
+treaty (including future time extensions), (iii) in any current or future
+medium and for any number of copies, and (iv) for any purpose whatsoever,
+including without limitation commercial, advertising or promotional
+purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
+member of the public at large and to the detriment of Affirmer's heirs and
+successors, fully intending that such Waiver shall not be subject to
+revocation, rescission, cancellation, termination, or any other legal or
+equitable action to disrupt the quiet enjoyment of the Work by the public
+as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+be judged legally invalid or ineffective under applicable law, then the
+Waiver shall be preserved to the maximum extent permitted taking into
+account Affirmer's express Statement of Purpose. In addition, to the
+extent the Waiver is so judged Affirmer hereby grants to each affected
+person a royalty-free, non transferable, non sublicensable, non exclusive,
+irrevocable and unconditional license to exercise Affirmer's Copyright and
+Related Rights in the Work (i) in all territories worldwide, (ii) for the
+maximum duration provided by applicable law or treaty (including future
+time extensions), (iii) in any current or future medium and for any number
+of copies, and (iv) for any purpose whatsoever, including without
+limitation commercial, advertising or promotional purposes (the
+"License"). The License shall be deemed effective as of the date CC0 was
+applied by Affirmer to the Work. Should any part of the License for any
+reason be judged legally invalid or ineffective under applicable law, such
+partial invalidity or ineffectiveness shall not invalidate the remainder
+of the License, and in such case Affirmer hereby affirms that he or she
+will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of
+action with respect to the Work, in either case contrary to Affirmer's
+express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+ a. No trademark or patent rights held by Affirmer are waived, abandoned,
+ surrendered, licensed or otherwise affected by this document.
+ b. Affirmer offers the Work as-is and makes no representations or
+ warranties of any kind concerning the Work, express, implied,
+ statutory or otherwise, including without limitation warranties of
+ title, merchantability, fitness for a particular purpose, non
+ infringement, or the absence of latent or other defects, accuracy, or
+ the present or absence of errors, whether or not discoverable, all to
+ the greatest extent permissible under applicable law.
+ c. Affirmer disclaims responsibility for clearing rights of (a) any
+ person's image or likeness depicted in the Work, or (b) any other
+ persons that may apply to the Work or any use thereof, including
+ without limitation person's Copyright and Related Rights in the Work.
+ Further, Affirmer disclaims responsibility for obtaining any necessary
+ consents, permissions or other rights required for any use of the
+ Work.
+ d. Affirmer understands and acknowledges that Creative Commons is not a
+ party to this document and has no duty or obligation with respect to
+ this CC0 or use of the Work.
diff --git a/hubs/awesome-embodied-agents/README.md b/hubs/awesome-embodied-agents/README.md
new file mode 100644
index 000000000..ebe194e78
--- /dev/null
+++ b/hubs/awesome-embodied-agents/README.md
@@ -0,0 +1,205 @@
+# Awesome Embodied Agents
+
+> A curated, community-fed directory of the tools, models, runtimes and platforms that give AI agents a face, a voice and a body.
+
+AI agents are moving off the text box. They talk through animated avatars, lip-sync in real time, walk around game worlds and show up as digital humans in your browser. The pieces that make this work are scattered across research repos, game engines, avatar formats and hosted APIs. This list puts them in one place, organized by what you are trying to build.
+
+Everything here is a real, linked project, stored as plain JSON in [`data/entries.json`](data/entries.json) so it is easy to review, diff, search and reuse.
+
+## Add your project
+
+Pull requests are the front door. Add one object to `data/entries.json`, run `node scripts/validate.mjs`, run `node scripts/build-readme.mjs`, and open a PR. The full steps and field rules are in [CONTRIBUTING.md](CONTRIBUTING.md). Prefer not to edit JSON? [Open an issue](.github/ISSUE_TEMPLATE/add-project.md) and a maintainer will add it for you.
+
+## Categories
+
+<!-- INDEX:START -->
+
+- [AI Avatars and Digital Human Frameworks](#ai-avatars-and-digital-human-frameworks) (9)
+- [Digital Human Platforms and APIs](#digital-human-platforms-and-apis) (6)
+- [Realtime Voice and Video Agent Infrastructure](#realtime-voice-and-video-agent-infrastructure) (2)
+- [Web 3D Runtimes](#web-3d-runtimes) (5)
+- [VRM and glTF Tooling](#vrm-and-gltf-tooling) (8)
+- [Lip-Sync and Facial Animation](#lip-sync-and-facial-animation) (12)
+- [Avatar and Character Creators](#avatar-and-character-creators) (10)
+- [Rigging, Retargeting and Motion](#rigging-retargeting-and-motion) (7)
+- [Performance Capture and VTubing](#performance-capture-and-vtubing) (10)
+- [Agents in 3D Worlds](#agents-in-3d-worlds) (9)
+
+<!-- INDEX:END -->
+
+## Projects
+
+Each table is sorted alphabetically. Status is `active` (maintained), `early` (new or experimental) or `archived` (stable reference, no longer updated).
+
+<!-- ENTRIES:START -->
+
+### AI Avatars and Digital Human Frameworks
+
+Open-source frameworks and apps that give an AI agent a face, a voice and a body you can talk to.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [AIAvatarKit](https://github.com/uezo/aiavatarkit) | Framework for quickly building conversational AI avatar applications. | [repo](https://github.com/uezo/aiavatarkit) | active |
+| [Amica](https://github.com/semperai/amica) | Open-source interface for interactive communication with 3D characters using voice synthesis and speech recognition. | [repo](https://github.com/semperai/amica) | active |
+| [ChatdollKit](https://github.com/uezo/ChatdollKit) | Unity SDK for building voice-enabled chatbots around 3D character models, with lip-sync, expressions and animations. | [repo](https://github.com/uezo/ChatdollKit) | active |
+| [LiveTalking](https://github.com/lipku/LiveTalking) | Real-time interactive streaming digital human with speech-driven lip-sync and WebRTC output. | [repo](https://github.com/lipku/LiveTalking) | active |
+| [Open-LLM-VTuber](https://github.com/Open-LLM-VTuber/Open-LLM-VTuber) | Talk to any LLM with hands-free voice, interruption and a Live2D avatar, running locally across platforms. | [repo](https://github.com/Open-LLM-VTuber/Open-LLM-VTuber) | active |
+| [OpenAvatarChat](https://github.com/HumanAIGC-Engineering/OpenAvatarChat) | Modular implementation of an interactive digital human conversation pipeline. | [repo](https://github.com/HumanAIGC-Engineering/OpenAvatarChat) | active |
+| [Project AIRI](https://github.com/moeru-ai/airi) | Self-hosted AI companion and VTuber project with web-based Live2D and VRM avatars and voice chat. | [repo](https://github.com/moeru-ai/airi) | active |
+| [TalkingHead](https://github.com/met4citizen/TalkingHead) | JavaScript class for real-time lip-sync talking avatars in the browser using three.js and full-body GLB avatars. | [repo](https://github.com/met4citizen/TalkingHead) | active |
+| [three.ws](https://three.ws) | Platform for creating embodied AI agents with 3D avatars, embeddable on any site with the agent-3d web component. | | active |
+
+### Digital Human Platforms and APIs
+
+Hosted services for conversational avatars, interactive video agents and AI characters.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [Anam](https://anam.ai) | API for building real-time, low-latency interactive AI avatars for support, training and sales. | | active |
+| [Convai](https://www.convai.com) | Conversational AI service for games, XR and the metaverse that brings 3D characters to life. | | active |
+| [Simli](https://www.simli.com) | End-to-end API for generating real-time video conversations with AI avatars. | | active |
+| [Soul Machines](https://www.soulmachines.com) | Platform for deploying lifelike digital workers and AI agents with animated digital faces. | | active |
+| [Synthesia](https://www.synthesia.io) | AI video platform that generates presenter-led videos with AI avatars in over 140 languages. | | active |
+| [Tavus](https://www.tavus.io) | API and no-code builder for real-time, face-to-face interactive AI video agents that see, hear and respond. | | active |
+
+### Realtime Voice and Video Agent Infrastructure
+
+Frameworks that stream speech, video and avatar output between users and agents with low latency.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [LiveKit Agents](https://github.com/livekit/agents) | Framework for building realtime voice and video AI agents that join LiveKit rooms. | [repo](https://github.com/livekit/agents) | active |
+| [Pipecat](https://github.com/pipecat-ai/pipecat) | Open-source framework for voice agents, multimodal apps and realtime AI, maintained by Daily and the community. | [repo](https://github.com/pipecat-ai/pipecat) | active |
+
+### Web 3D Runtimes
+
+Engines and component libraries that render and animate characters in the browser.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [Babylon.js](https://www.babylonjs.com) | Powerful, beautiful, simple and open web rendering engine with glTF, skeletal animation and WebXR support. | [repo](https://github.com/BabylonJS/Babylon.js) | active |
+| [drei](https://github.com/pmndrs/drei) | Collection of helpers and abstractions for React Three Fiber, including model loaders, controls and animation hooks. | [repo](https://github.com/pmndrs/drei) | active |
+| [model-viewer](https://modelviewer.dev) | Web component for displaying interactive 3D glTF models with animation and AR on the web. | [repo](https://github.com/google/model-viewer) | active |
+| [React Three Fiber](https://github.com/pmndrs/react-three-fiber) | React renderer for three.js that builds 3D scenes declaratively with components and hooks. | [repo](https://github.com/pmndrs/react-three-fiber) | active |
+| [three.js](https://threejs.org) | JavaScript 3D library that renders scenes, skinned characters and glTF models in the browser with WebGL and WebGPU. | [repo](https://github.com/mrdoob/three.js) | active |
+
+### VRM and glTF Tooling
+
+Specifications, loaders, importers and optimizers for portable avatar and model formats.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [glTF](https://www.khronos.org/gltf/) | Khronos specification for the open royalty-free 3D asset transmission format used by most web avatars. | [repo](https://github.com/KhronosGroup/glTF) | active |
+| [glTF Transform](https://gltf-transform.dev) | JavaScript SDK and CLI to read, edit, optimize and compress glTF 3D models. | [repo](https://github.com/donmccurdy/glTF-Transform) | active |
+| [godot-vrm](https://github.com/V-Sekai/godot-vrm) | Godot Engine extension that imports and runs VRM avatars at runtime and in the editor. | [repo](https://github.com/V-Sekai/godot-vrm) | active |
+| [meshoptimizer](https://github.com/zeux/meshoptimizer) | Mesh optimization and compression library that includes the gltfpack tool for shrinking glTF avatars. | [repo](https://github.com/zeux/meshoptimizer) | active |
+| [three-vrm](https://github.com/pixiv/three-vrm) | three.js library from pixiv for loading, rendering and animating VRM avatars, including expressions and spring bones. | [repo](https://github.com/pixiv/three-vrm) | active |
+| [UniVRM](https://github.com/vrm-c/UniVRM) | Unity package for importing, exporting and runtime loading of VRM avatar files. | [repo](https://github.com/vrm-c/UniVRM) | active |
+| [VRM Add-on for Blender](https://vrm-addon-for-blender.info) | Blender add-on to import, export and edit VRM humanoid avatar files. | [repo](https://github.com/saturday06/VRM-Addon-for-Blender) | active |
+| [VRM Specification](https://github.com/vrm-c/vrm-specification) | Official specification and glTF extensions for the VRM 3D humanoid avatar format. | [repo](https://github.com/vrm-c/vrm-specification) | active |
+
+### Lip-Sync and Facial Animation
+
+Audio-driven and video-driven face animation, visemes, blendshapes and talking-head models.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [EchoMimic](https://github.com/antgroup/echomimic) | Audio-driven portrait animation model from Ant Group that produces lifelike talking-head video. | [repo](https://github.com/antgroup/echomimic) | active |
+| [FaceFormer](https://github.com/EvelynFan/FaceFormer) | CVPR 2022 transformer model for speech-driven 3D facial animation. | [repo](https://github.com/EvelynFan/FaceFormer) | active |
+| [Hallo](https://github.com/fudan-generative-vision/hallo) | Hierarchical audio-driven visual synthesis model for portrait image animation from Fudan University. | [repo](https://github.com/fudan-generative-vision/hallo) | active |
+| [HeadTTS](https://github.com/met4citizen/HeadTTS) | Free neural text-to-speech for browser and Node.js that returns audio with word timestamps and visemes. | [repo](https://github.com/met4citizen/HeadTTS) | active |
+| [LivePortrait](https://github.com/KlingAIResearch/LivePortrait) | Efficient portrait animation model with stitching and retargeting control. | [repo](https://github.com/KlingAIResearch/LivePortrait) | active |
+| [MediaPipe](https://ai.google.dev/edge/mediapipe) | Google on-device ML framework with face landmark and blendshape tasks for driving avatars from a camera. | [repo](https://github.com/google-ai-edge/mediapipe) | active |
+| [MuseTalk](https://github.com/TMElyralab/MuseTalk) | Real-time, high-quality lip synchronization using latent space inpainting. | [repo](https://github.com/TMElyralab/MuseTalk) | active |
+| [NVIDIA Audio2Face-3D](https://github.com/NVIDIA/Audio2Face-3D) | NVIDIA SDK and tools that generate facial animation from audio for 3D characters. | [repo](https://github.com/NVIDIA/Audio2Face-3D) | active |
+| [Rhubarb Lip Sync](https://github.com/DanielSWolf/rhubarb-lip-sync) | Command-line tool that analyzes recorded speech and outputs mouth shape cues for 2D and 3D animation. | [repo](https://github.com/DanielSWolf/rhubarb-lip-sync) | active |
+| [SadTalker](https://github.com/OpenTalker/SadTalker) | CVPR 2023 model that turns a single portrait image and audio into a stylized talking-head video. | [repo](https://github.com/OpenTalker/SadTalker) | active |
+| [uLipSync](https://github.com/hecomi/uLipSync) | MFCC-based lip-sync plugin for Unity that runs on audio input in real time. | [repo](https://github.com/hecomi/uLipSync) | active |
+| [Wav2Lip](https://github.com/Rudrabha/Wav2Lip) | Research code that lip-syncs a face in video to any target speech audio. | [repo](https://github.com/Rudrabha/Wav2Lip) | active |
+
+### Avatar and Character Creators
+
+Tools and models that build 3D characters from sliders, photos, images or text.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [Avaturn](https://avaturn.me) | Creates a realistic 3D avatar from a selfie, exports a 3D model and offers an SDK for apps. | | active |
+| [Character Creator](https://www.reallusion.com/character-creator/) | Reallusion tool for building rigged 3D characters with morphs, with Unreal, Unity and Blender integration. | | active |
+| [GaussianAvatars](https://github.com/ShenhanQian/GaussianAvatars) | CVPR 2024 method for photorealistic head avatars built from rigged 3D Gaussians. | [repo](https://github.com/ShenhanQian/GaussianAvatars) | active |
+| [Hunyuan3D-2](https://github.com/Tencent-Hunyuan/Hunyuan3D-2) | High-resolution 3D asset generation with large-scale Hunyuan3D diffusion models from Tencent. | [repo](https://github.com/Tencent-Hunyuan/Hunyuan3D-2) | active |
+| [LAM](https://github.com/aigc3d/LAM) | SIGGRAPH 2025 Large Avatar Model for one-shot, animatable Gaussian head avatars. | [repo](https://github.com/aigc3d/LAM) | active |
+| [MakeHuman](https://github.com/makehumancommunity/makehuman) | Open-source tool for modeling parametric 3D humanoid characters. | [repo](https://github.com/makehumancommunity/makehuman) | active |
+| [Meshcapade](https://meshcapade.com) | Foundation models that teach AI to see, understand and move, built around 3D human body and motion. | | active |
+| [MPFB2](https://github.com/makehumancommunity/mpfb2) | Blender add-on that brings the MakeHuman human generator into Blender as a native character creator. | [repo](https://github.com/makehumancommunity/mpfb2) | active |
+| [TRELLIS](https://github.com/microsoft/TRELLIS) | Microsoft structured 3D latents model for generating 3D assets from text or images. | [repo](https://github.com/microsoft/TRELLIS) | active |
+| [VRoid Studio](https://vroid.com/en/studio) | Free application from pixiv for creating 3D anime-style humanoid avatars that export to VRM. | | active |
+
+### Rigging, Retargeting and Motion
+
+Auto-rigging, body models and motion generation for animating characters.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [Animated Drawings](https://github.com/facebookresearch/AnimatedDrawings) | Meta research code that animates children's drawings of human figures. | [repo](https://github.com/facebookresearch/AnimatedDrawings) | archived |
+| [Human Motion Diffusion Model](https://github.com/GuyTevet/motion-diffusion-model) | Official PyTorch implementation of the Human Motion Diffusion Model paper. | [repo](https://github.com/GuyTevet/motion-diffusion-model) | active |
+| [Mixamo](https://www.mixamo.com) | Adobe service that auto-rigs humanoid 3D characters and offers a large library of motion clips. | | active |
+| [MotionGPT](https://github.com/OpenMotionLab/MotionGPT) | NeurIPS 2023 model that treats human motion as a foreign language for unified motion-language generation. | [repo](https://github.com/OpenMotionLab/MotionGPT) | active |
+| [RigNet](https://github.com/zhan-xu/RigNet) | SIGGRAPH 2020 neural rigging for articulated characters. | [repo](https://github.com/zhan-xu/RigNet) | archived |
+| [SMPL-X](https://github.com/vchoutas/smplx) | PyTorch implementation of the SMPL, SMPL-H and SMPL-X expressive parametric human body models. | [repo](https://github.com/vchoutas/smplx) | active |
+| [UniRig](https://github.com/VAST-AI-Research/UniRig) | Automatic skeleton and skinning-weight prediction for diverse 3D models. | [repo](https://github.com/VAST-AI-Research/UniRig) | active |
+
+### Performance Capture and VTubing
+
+Webcam and sensor tracking, Live2D and 3D puppeteering software for driving avatars live.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [FreeMoCap](https://github.com/freemocap/freemocap) | Free, open-source markerless motion capture system built for everyone. | [repo](https://github.com/freemocap/freemocap) | active |
+| [Inochi2D](https://github.com/Inochi2D/inochi2d) | Open-source 2D puppet animation framework and SDK for bringing characters to life. | [repo](https://github.com/Inochi2D/inochi2d) | active |
+| [Kalidokit](https://github.com/yeemachine/kalidokit) | Blendshape and kinematics solver for MediaPipe face, pose and hand tracking that drives VRM and Live2D models. | [repo](https://github.com/yeemachine/kalidokit) | active |
+| [Live2D Cubism](https://www.live2d.com) | Industry-standard tool and SDKs for real-time 2D character animation used in games and VTubing. | | active |
+| [pixi-live2d-display](https://github.com/guansss/pixi-live2d-display) | PixiJS plugin to display and interact with Live2D models in the browser. | [repo](https://github.com/guansss/pixi-live2d-display) | active |
+| [VMagicMirror](https://github.com/malaybaku/VMagicMirror) | Windows VRM software that moves an avatar with minimal devices. | [repo](https://github.com/malaybaku/VMagicMirror) | active |
+| [VSeeFace](https://www.vseeface.icu) | Free VTuber application that animates 3D VRM avatars from webcam tracking. | | active |
+| [VTube Studio](https://github.com/DenchiSoft/VTubeStudio) | Live2D VTuber app whose public API lets external plugins and agents control models. | [repo](https://github.com/DenchiSoft/VTubeStudio) | active |
+| [Warudo](https://warudo.app) | 3D VTubing software with face and hand tracking, custom 3D assets, streaming integrations and a blueprint system. | | active |
+| [XR Animator](https://github.com/ButzYung/SystemAnimatorOnline) | AI-based full-body motion capture and extended reality solution powered by System Animator Online. | [repo](https://github.com/ButzYung/SystemAnimatorOnline) | active |
+
+### Agents in 3D Worlds
+
+Simulators, game environments and frameworks where agents perceive and act inside 3D spaces.
+
+| Project | Description | Source | Status |
+| --- | --- | --- | --- |
+| [AI Town](https://github.com/a16z-infra/ai-town) | MIT-licensed starter kit for a virtual town where AI characters live, chat and socialize. | [repo](https://github.com/a16z-infra/ai-town) | active |
+| [AI2-THOR](https://github.com/allenai/ai2thor) | Open-source platform for visual AI with interactive 3D household environments. | [repo](https://github.com/allenai/ai2thor) | active |
+| [Generative Agents](https://github.com/joonspk-research/generative_agents) | Code for the Stanford paper on interactive simulacra of human behavior in a sandbox town. | [repo](https://github.com/joonspk-research/generative_agents) | archived |
+| [Genesis](https://github.com/Genesis-Embodied-AI/Genesis) | Generative physics engine and simulation platform for robotics and embodied AI. | [repo](https://github.com/Genesis-Embodied-AI/Genesis) | active |
+| [Habitat-Lab](https://github.com/facebookresearch/habitat-lab) | Modular high-level library to train embodied AI agents across tasks and simulated 3D environments. | [repo](https://github.com/facebookresearch/habitat-lab) | active |
+| [Mindcraft](https://github.com/kolbytn/mindcraft) | Minecraft agents driven by large language models, built on Mineflayer. | [repo](https://github.com/kolbytn/mindcraft) | active |
+| [Mineflayer](https://github.com/PrismarineJS/mineflayer) | JavaScript API for creating Minecraft bots that perceive and act in the world. | [repo](https://github.com/PrismarineJS/mineflayer) | active |
+| [Unity ML-Agents](https://github.com/Unity-Technologies/ml-agents) | Unity toolkit that turns games and simulations into environments for training intelligent agents. | [repo](https://github.com/Unity-Technologies/ml-agents) | active |
+| [Voyager](https://github.com/MineDojo/Voyager) | Open-ended embodied agent in Minecraft driven by large language models. | [repo](https://github.com/MineDojo/Voyager) | archived |
+
+<!-- ENTRIES:END -->
+
+## Use the data
+
+The whole directory is machine-readable:
+
+- [`data/entries.json`](data/entries.json): every project with category, status and source link.
+- [`data/categories.json`](data/categories.json): the ordered category list.
+- [`data/schema.json`](data/schema.json): JSON Schema for entries.
+
+Fork it, build a site on it, or feed it to your agent. No attribution is required.
+
+## Scripts
+
+- `node scripts/validate.mjs` checks required fields, unique ids, valid URLs, categories, description length, dash characters and sort order.
+- `node scripts/build-readme.mjs` regenerates the index and tables in this README from the JSON.
+
+Both are dependency-free and need Node 18 or newer.
+
+## License
+
+[CC0 1.0 Universal](LICENSE). To the extent possible under law, the contributors have waived all copyright and related rights to this directory. Listed projects keep their own licenses and trademarks.
diff --git a/hubs/awesome-embodied-agents/data/categories.json b/hubs/awesome-embodied-agents/data/categories.json
new file mode 100644
index 000000000..96fa2a382
--- /dev/null
+++ b/hubs/awesome-embodied-agents/data/categories.json
@@ -0,0 +1,52 @@
+[
+ {
+ "id": "avatar-agents",
+ "title": "AI Avatars and Digital Human Frameworks",
+ "blurb": "Open-source frameworks and apps that give an AI agent a face, a voice and a body you can talk to."
+ },
+ {
+ "id": "digital-human-platforms",
+ "title": "Digital Human Platforms and APIs",
+ "blurb": "Hosted services for conversational avatars, interactive video agents and AI characters."
+ },
+ {
+ "id": "realtime-agent-infra",
+ "title": "Realtime Voice and Video Agent Infrastructure",
+ "blurb": "Frameworks that stream speech, video and avatar output between users and agents with low latency."
+ },
+ {
+ "id": "web-3d-runtimes",
+ "title": "Web 3D Runtimes",
+ "blurb": "Engines and component libraries that render and animate characters in the browser."
+ },
+ {
+ "id": "vrm-gltf-tooling",
+ "title": "VRM and glTF Tooling",
+ "blurb": "Specifications, loaders, importers and optimizers for portable avatar and model formats."
+ },
+ {
+ "id": "lip-sync-facial",
+ "title": "Lip-Sync and Facial Animation",
+ "blurb": "Audio-driven and video-driven face animation, visemes, blendshapes and talking-head models."
+ },
+ {
+ "id": "avatar-creators",
+ "title": "Avatar and Character Creators",
+ "blurb": "Tools and models that build 3D characters from sliders, photos, images or text."
+ },
+ {
+ "id": "rigging-retargeting-motion",
+ "title": "Rigging, Retargeting and Motion",
+ "blurb": "Auto-rigging, body models and motion generation for animating characters."
+ },
+ {
+ "id": "performance-capture-vtubing",
+ "title": "Performance Capture and VTubing",
+ "blurb": "Webcam and sensor tracking, Live2D and 3D puppeteering software for driving avatars live."
+ },
+ {
+ "id": "agent-in-3d",
+ "title": "Agents in 3D Worlds",
+ "blurb": "Simulators, game environments and frameworks where agents perceive and act inside 3D spaces."
+ }
+]
diff --git a/hubs/awesome-embodied-agents/data/entries.json b/hubs/awesome-embodied-agents/data/entries.json
new file mode 100644
index 000000000..69d0aa4f8
--- /dev/null
+++ b/hubs/awesome-embodied-agents/data/entries.json
@@ -0,0 +1,860 @@
+[
+ {
+ "id": "aiavatarkit",
+ "name": "AIAvatarKit",
+ "url": "https://github.com/uezo/aiavatarkit",
+ "repo": "https://github.com/uezo/aiavatarkit",
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "Framework for quickly building conversational AI avatar applications.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "amica",
+ "name": "Amica",
+ "url": "https://github.com/semperai/amica",
+ "repo": "https://github.com/semperai/amica",
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "Open-source interface for interactive communication with 3D characters using voice synthesis and speech recognition.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "chatdollkit",
+ "name": "ChatdollKit",
+ "url": "https://github.com/uezo/ChatdollKit",
+ "repo": "https://github.com/uezo/ChatdollKit",
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "Unity SDK for building voice-enabled chatbots around 3D character models, with lip-sync, expressions and animations.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "livetalking",
+ "name": "LiveTalking",
+ "url": "https://github.com/lipku/LiveTalking",
+ "repo": "https://github.com/lipku/LiveTalking",
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "Real-time interactive streaming digital human with speech-driven lip-sync and WebRTC output.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "open-llm-vtuber",
+ "name": "Open-LLM-VTuber",
+ "url": "https://github.com/Open-LLM-VTuber/Open-LLM-VTuber",
+ "repo": "https://github.com/Open-LLM-VTuber/Open-LLM-VTuber",
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "Talk to any LLM with hands-free voice, interruption and a Live2D avatar, running locally across platforms.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "openavatarchat",
+ "name": "OpenAvatarChat",
+ "url": "https://github.com/HumanAIGC-Engineering/OpenAvatarChat",
+ "repo": "https://github.com/HumanAIGC-Engineering/OpenAvatarChat",
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "Modular implementation of an interactive digital human conversation pipeline.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "project-airi",
+ "name": "Project AIRI",
+ "url": "https://github.com/moeru-ai/airi",
+ "repo": "https://github.com/moeru-ai/airi",
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "Self-hosted AI companion and VTuber project with web-based Live2D and VRM avatars and voice chat.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "talkinghead",
+ "name": "TalkingHead",
+ "url": "https://github.com/met4citizen/TalkingHead",
+ "repo": "https://github.com/met4citizen/TalkingHead",
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "JavaScript class for real-time lip-sync talking avatars in the browser using three.js and full-body GLB avatars.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "three-ws",
+ "name": "three.ws",
+ "url": "https://three.ws",
+ "repo": null,
+ "category": "avatar-agents",
+ "chain": "none",
+ "description": "Platform for creating embodied AI agents with 3D avatars, embeddable on any site with the agent-3d web component.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "anam",
+ "name": "Anam",
+ "url": "https://anam.ai",
+ "repo": null,
+ "category": "digital-human-platforms",
+ "chain": "none",
+ "description": "API for building real-time, low-latency interactive AI avatars for support, training and sales.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "convai",
+ "name": "Convai",
+ "url": "https://www.convai.com",
+ "repo": null,
+ "category": "digital-human-platforms",
+ "chain": "none",
+ "description": "Conversational AI service for games, XR and the metaverse that brings 3D characters to life.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "simli",
+ "name": "Simli",
+ "url": "https://www.simli.com",
+ "repo": null,
+ "category": "digital-human-platforms",
+ "chain": "none",
+ "description": "End-to-end API for generating real-time video conversations with AI avatars.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "soul-machines",
+ "name": "Soul Machines",
+ "url": "https://www.soulmachines.com",
+ "repo": null,
+ "category": "digital-human-platforms",
+ "chain": "none",
+ "description": "Platform for deploying lifelike digital workers and AI agents with animated digital faces.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "synthesia",
+ "name": "Synthesia",
+ "url": "https://www.synthesia.io",
+ "repo": null,
+ "category": "digital-human-platforms",
+ "chain": "none",
+ "description": "AI video platform that generates presenter-led videos with AI avatars in over 140 languages.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "tavus",
+ "name": "Tavus",
+ "url": "https://www.tavus.io",
+ "repo": null,
+ "category": "digital-human-platforms",
+ "chain": "none",
+ "description": "API and no-code builder for real-time, face-to-face interactive AI video agents that see, hear and respond.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "livekit-agents",
+ "name": "LiveKit Agents",
+ "url": "https://github.com/livekit/agents",
+ "repo": "https://github.com/livekit/agents",
+ "category": "realtime-agent-infra",
+ "chain": "none",
+ "description": "Framework for building realtime voice and video AI agents that join LiveKit rooms.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "pipecat",
+ "name": "Pipecat",
+ "url": "https://github.com/pipecat-ai/pipecat",
+ "repo": "https://github.com/pipecat-ai/pipecat",
+ "category": "realtime-agent-infra",
+ "chain": "none",
+ "description": "Open-source framework for voice agents, multimodal apps and realtime AI, maintained by Daily and the community.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "babylon-js",
+ "name": "Babylon.js",
+ "url": "https://www.babylonjs.com",
+ "repo": "https://github.com/BabylonJS/Babylon.js",
+ "category": "web-3d-runtimes",
+ "chain": "none",
+ "description": "Powerful, beautiful, simple and open web rendering engine with glTF, skeletal animation and WebXR support.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "drei",
+ "name": "drei",
+ "url": "https://github.com/pmndrs/drei",
+ "repo": "https://github.com/pmndrs/drei",
+ "category": "web-3d-runtimes",
+ "chain": "none",
+ "description": "Collection of helpers and abstractions for React Three Fiber, including model loaders, controls and animation hooks.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "model-viewer",
+ "name": "model-viewer",
+ "url": "https://modelviewer.dev",
+ "repo": "https://github.com/google/model-viewer",
+ "category": "web-3d-runtimes",
+ "chain": "none",
+ "description": "Web component for displaying interactive 3D glTF models with animation and AR on the web.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "react-three-fiber",
+ "name": "React Three Fiber",
+ "url": "https://github.com/pmndrs/react-three-fiber",
+ "repo": "https://github.com/pmndrs/react-three-fiber",
+ "category": "web-3d-runtimes",
+ "chain": "none",
+ "description": "React renderer for three.js that builds 3D scenes declaratively with components and hooks.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "three-js",
+ "name": "three.js",
+ "url": "https://threejs.org",
+ "repo": "https://github.com/mrdoob/three.js",
+ "category": "web-3d-runtimes",
+ "chain": "none",
+ "description": "JavaScript 3D library that renders scenes, skinned characters and glTF models in the browser with WebGL and WebGPU.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "gltf",
+ "name": "glTF",
+ "url": "https://www.khronos.org/gltf/",
+ "repo": "https://github.com/KhronosGroup/glTF",
+ "category": "vrm-gltf-tooling",
+ "chain": "none",
+ "description": "Khronos specification for the open royalty-free 3D asset transmission format used by most web avatars.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "gltf-transform",
+ "name": "glTF Transform",
+ "url": "https://gltf-transform.dev",
+ "repo": "https://github.com/donmccurdy/glTF-Transform",
+ "category": "vrm-gltf-tooling",
+ "chain": "none",
+ "description": "JavaScript SDK and CLI to read, edit, optimize and compress glTF 3D models.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "godot-vrm",
+ "name": "godot-vrm",
+ "url": "https://github.com/V-Sekai/godot-vrm",
+ "repo": "https://github.com/V-Sekai/godot-vrm",
+ "category": "vrm-gltf-tooling",
+ "chain": "none",
+ "description": "Godot Engine extension that imports and runs VRM avatars at runtime and in the editor.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "meshoptimizer",
+ "name": "meshoptimizer",
+ "url": "https://github.com/zeux/meshoptimizer",
+ "repo": "https://github.com/zeux/meshoptimizer",
+ "category": "vrm-gltf-tooling",
+ "chain": "none",
+ "description": "Mesh optimization and compression library that includes the gltfpack tool for shrinking glTF avatars.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "three-vrm",
+ "name": "three-vrm",
+ "url": "https://github.com/pixiv/three-vrm",
+ "repo": "https://github.com/pixiv/three-vrm",
+ "category": "vrm-gltf-tooling",
+ "chain": "none",
+ "description": "three.js library from pixiv for loading, rendering and animating VRM avatars, including expressions and spring bones.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "univrm",
+ "name": "UniVRM",
+ "url": "https://github.com/vrm-c/UniVRM",
+ "repo": "https://github.com/vrm-c/UniVRM",
+ "category": "vrm-gltf-tooling",
+ "chain": "none",
+ "description": "Unity package for importing, exporting and runtime loading of VRM avatar files.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "vrm-add-on-for-blender",
+ "name": "VRM Add-on for Blender",
+ "url": "https://vrm-addon-for-blender.info",
+ "repo": "https://github.com/saturday06/VRM-Addon-for-Blender",
+ "category": "vrm-gltf-tooling",
+ "chain": "none",
+ "description": "Blender add-on to import, export and edit VRM humanoid avatar files.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "vrm-specification",
+ "name": "VRM Specification",
+ "url": "https://github.com/vrm-c/vrm-specification",
+ "repo": "https://github.com/vrm-c/vrm-specification",
+ "category": "vrm-gltf-tooling",
+ "chain": "none",
+ "description": "Official specification and glTF extensions for the VRM 3D humanoid avatar format.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "echomimic",
+ "name": "EchoMimic",
+ "url": "https://github.com/antgroup/echomimic",
+ "repo": "https://github.com/antgroup/echomimic",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "Audio-driven portrait animation model from Ant Group that produces lifelike talking-head video.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "faceformer",
+ "name": "FaceFormer",
+ "url": "https://github.com/EvelynFan/FaceFormer",
+ "repo": "https://github.com/EvelynFan/FaceFormer",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "CVPR 2022 transformer model for speech-driven 3D facial animation.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "hallo",
+ "name": "Hallo",
+ "url": "https://github.com/fudan-generative-vision/hallo",
+ "repo": "https://github.com/fudan-generative-vision/hallo",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "Hierarchical audio-driven visual synthesis model for portrait image animation from Fudan University.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "headtts",
+ "name": "HeadTTS",
+ "url": "https://github.com/met4citizen/HeadTTS",
+ "repo": "https://github.com/met4citizen/HeadTTS",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "Free neural text-to-speech for browser and Node.js that returns audio with word timestamps and visemes.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "liveportrait",
+ "name": "LivePortrait",
+ "url": "https://github.com/KlingAIResearch/LivePortrait",
+ "repo": "https://github.com/KlingAIResearch/LivePortrait",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "Efficient portrait animation model with stitching and retargeting control.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "mediapipe",
+ "name": "MediaPipe",
+ "url": "https://ai.google.dev/edge/mediapipe",
+ "repo": "https://github.com/google-ai-edge/mediapipe",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "Google on-device ML framework with face landmark and blendshape tasks for driving avatars from a camera.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "musetalk",
+ "name": "MuseTalk",
+ "url": "https://github.com/TMElyralab/MuseTalk",
+ "repo": "https://github.com/TMElyralab/MuseTalk",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "Real-time, high-quality lip synchronization using latent space inpainting.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "nvidia-audio2face-3d",
+ "name": "NVIDIA Audio2Face-3D",
+ "url": "https://github.com/NVIDIA/Audio2Face-3D",
+ "repo": "https://github.com/NVIDIA/Audio2Face-3D",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "NVIDIA SDK and tools that generate facial animation from audio for 3D characters.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "rhubarb-lip-sync",
+ "name": "Rhubarb Lip Sync",
+ "url": "https://github.com/DanielSWolf/rhubarb-lip-sync",
+ "repo": "https://github.com/DanielSWolf/rhubarb-lip-sync",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "Command-line tool that analyzes recorded speech and outputs mouth shape cues for 2D and 3D animation.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "sadtalker",
+ "name": "SadTalker",
+ "url": "https://github.com/OpenTalker/SadTalker",
+ "repo": "https://github.com/OpenTalker/SadTalker",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "CVPR 2023 model that turns a single portrait image and audio into a stylized talking-head video.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "ulipsync",
+ "name": "uLipSync",
+ "url": "https://github.com/hecomi/uLipSync",
+ "repo": "https://github.com/hecomi/uLipSync",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "MFCC-based lip-sync plugin for Unity that runs on audio input in real time.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "wav2lip",
+ "name": "Wav2Lip",
+ "url": "https://github.com/Rudrabha/Wav2Lip",
+ "repo": "https://github.com/Rudrabha/Wav2Lip",
+ "category": "lip-sync-facial",
+ "chain": "none",
+ "description": "Research code that lip-syncs a face in video to any target speech audio.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "avaturn",
+ "name": "Avaturn",
+ "url": "https://avaturn.me",
+ "repo": null,
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "Creates a realistic 3D avatar from a selfie, exports a 3D model and offers an SDK for apps.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "character-creator",
+ "name": "Character Creator",
+ "url": "https://www.reallusion.com/character-creator/",
+ "repo": null,
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "Reallusion tool for building rigged 3D characters with morphs, with Unreal, Unity and Blender integration.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "gaussianavatars",
+ "name": "GaussianAvatars",
+ "url": "https://github.com/ShenhanQian/GaussianAvatars",
+ "repo": "https://github.com/ShenhanQian/GaussianAvatars",
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "CVPR 2024 method for photorealistic head avatars built from rigged 3D Gaussians.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "hunyuan3d-2",
+ "name": "Hunyuan3D-2",
+ "url": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2",
+ "repo": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2",
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "High-resolution 3D asset generation with large-scale Hunyuan3D diffusion models from Tencent.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "lam",
+ "name": "LAM",
+ "url": "https://github.com/aigc3d/LAM",
+ "repo": "https://github.com/aigc3d/LAM",
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "SIGGRAPH 2025 Large Avatar Model for one-shot, animatable Gaussian head avatars.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "makehuman",
+ "name": "MakeHuman",
+ "url": "https://github.com/makehumancommunity/makehuman",
+ "repo": "https://github.com/makehumancommunity/makehuman",
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "Open-source tool for modeling parametric 3D humanoid characters.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "meshcapade",
+ "name": "Meshcapade",
+ "url": "https://meshcapade.com",
+ "repo": null,
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "Foundation models that teach AI to see, understand and move, built around 3D human body and motion.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "mpfb2",
+ "name": "MPFB2",
+ "url": "https://github.com/makehumancommunity/mpfb2",
+ "repo": "https://github.com/makehumancommunity/mpfb2",
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "Blender add-on that brings the MakeHuman human generator into Blender as a native character creator.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "trellis",
+ "name": "TRELLIS",
+ "url": "https://github.com/microsoft/TRELLIS",
+ "repo": "https://github.com/microsoft/TRELLIS",
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "Microsoft structured 3D latents model for generating 3D assets from text or images.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "vroid-studio",
+ "name": "VRoid Studio",
+ "url": "https://vroid.com/en/studio",
+ "repo": null,
+ "category": "avatar-creators",
+ "chain": "none",
+ "description": "Free application from pixiv for creating 3D anime-style humanoid avatars that export to VRM.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "animated-drawings",
+ "name": "Animated Drawings",
+ "url": "https://github.com/facebookresearch/AnimatedDrawings",
+ "repo": "https://github.com/facebookresearch/AnimatedDrawings",
+ "category": "rigging-retargeting-motion",
+ "chain": "none",
+ "description": "Meta research code that animates children's drawings of human figures.",
+ "status": "archived",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "human-motion-diffusion-model",
+ "name": "Human Motion Diffusion Model",
+ "url": "https://github.com/GuyTevet/motion-diffusion-model",
+ "repo": "https://github.com/GuyTevet/motion-diffusion-model",
+ "category": "rigging-retargeting-motion",
+ "chain": "none",
+ "description": "Official PyTorch implementation of the Human Motion Diffusion Model paper.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "mixamo",
+ "name": "Mixamo",
+ "url": "https://www.mixamo.com",
+ "repo": null,
+ "category": "rigging-retargeting-motion",
+ "chain": "none",
+ "description": "Adobe service that auto-rigs humanoid 3D characters and offers a large library of motion clips.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "motiongpt",
+ "name": "MotionGPT",
+ "url": "https://github.com/OpenMotionLab/MotionGPT",
+ "repo": "https://github.com/OpenMotionLab/MotionGPT",
+ "category": "rigging-retargeting-motion",
+ "chain": "none",
+ "description": "NeurIPS 2023 model that treats human motion as a foreign language for unified motion-language generation.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "rignet",
+ "name": "RigNet",
+ "url": "https://github.com/zhan-xu/RigNet",
+ "repo": "https://github.com/zhan-xu/RigNet",
+ "category": "rigging-retargeting-motion",
+ "chain": "none",
+ "description": "SIGGRAPH 2020 neural rigging for articulated characters.",
+ "status": "archived",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "smpl-x",
+ "name": "SMPL-X",
+ "url": "https://github.com/vchoutas/smplx",
+ "repo": "https://github.com/vchoutas/smplx",
+ "category": "rigging-retargeting-motion",
+ "chain": "none",
+ "description": "PyTorch implementation of the SMPL, SMPL-H and SMPL-X expressive parametric human body models.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "unirig",
+ "name": "UniRig",
+ "url": "https://github.com/VAST-AI-Research/UniRig",
+ "repo": "https://github.com/VAST-AI-Research/UniRig",
+ "category": "rigging-retargeting-motion",
+ "chain": "none",
+ "description": "Automatic skeleton and skinning-weight prediction for diverse 3D models.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "freemocap",
+ "name": "FreeMoCap",
+ "url": "https://github.com/freemocap/freemocap",
+ "repo": "https://github.com/freemocap/freemocap",
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "Free, open-source markerless motion capture system built for everyone.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "inochi2d",
+ "name": "Inochi2D",
+ "url": "https://github.com/Inochi2D/inochi2d",
+ "repo": "https://github.com/Inochi2D/inochi2d",
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "Open-source 2D puppet animation framework and SDK for bringing characters to life.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "kalidokit",
+ "name": "Kalidokit",
+ "url": "https://github.com/yeemachine/kalidokit",
+ "repo": "https://github.com/yeemachine/kalidokit",
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "Blendshape and kinematics solver for MediaPipe face, pose and hand tracking that drives VRM and Live2D models.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "live2d-cubism",
+ "name": "Live2D Cubism",
+ "url": "https://www.live2d.com",
+ "repo": null,
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "Industry-standard tool and SDKs for real-time 2D character animation used in games and VTubing.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "pixi-live2d-display",
+ "name": "pixi-live2d-display",
+ "url": "https://github.com/guansss/pixi-live2d-display",
+ "repo": "https://github.com/guansss/pixi-live2d-display",
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "PixiJS plugin to display and interact with Live2D models in the browser.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "vmagicmirror",
+ "name": "VMagicMirror",
+ "url": "https://github.com/malaybaku/VMagicMirror",
+ "repo": "https://github.com/malaybaku/VMagicMirror",
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "Windows VRM software that moves an avatar with minimal devices.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "vseeface",
+ "name": "VSeeFace",
+ "url": "https://www.vseeface.icu",
+ "repo": null,
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "Free VTuber application that animates 3D VRM avatars from webcam tracking.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "vtube-studio",
+ "name": "VTube Studio",
+ "url": "https://github.com/DenchiSoft/VTubeStudio",
+ "repo": "https://github.com/DenchiSoft/VTubeStudio",
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "Live2D VTuber app whose public API lets external plugins and agents control models.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "warudo",
+ "name": "Warudo",
+ "url": "https://warudo.app",
+ "repo": null,
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "3D VTubing software with face and hand tracking, custom 3D assets, streaming integrations and a blueprint system.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "xr-animator",
+ "name": "XR Animator",
+ "url": "https://github.com/ButzYung/SystemAnimatorOnline",
+ "repo": "https://github.com/ButzYung/SystemAnimatorOnline",
+ "category": "performance-capture-vtubing",
+ "chain": "none",
+ "description": "AI-based full-body motion capture and extended reality solution powered by System Animator Online.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "ai-town",
+ "name": "AI Town",
+ "url": "https://github.com/a16z-infra/ai-town",
+ "repo": "https://github.com/a16z-infra/ai-town",
+ "category": "agent-in-3d",
+ "chain": "none",
+ "description": "MIT-licensed starter kit for a virtual town where AI characters live, chat and socialize.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "ai2-thor",
+ "name": "AI2-THOR",
+ "url": "https://github.com/allenai/ai2thor",
+ "repo": "https://github.com/allenai/ai2thor",
+ "category": "agent-in-3d",
+ "chain": "none",
+ "description": "Open-source platform for visual AI with interactive 3D household environments.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "generative-agents",
+ "name": "Generative Agents",
+ "url": "https://github.com/joonspk-research/generative_agents",
+ "repo": "https://github.com/joonspk-research/generative_agents",
+ "category": "agent-in-3d",
+ "chain": "none",
+ "description": "Code for the Stanford paper on interactive simulacra of human behavior in a sandbox town.",
+ "status": "archived",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "genesis",
+ "name": "Genesis",
+ "url": "https://github.com/Genesis-Embodied-AI/Genesis",
+ "repo": "https://github.com/Genesis-Embodied-AI/Genesis",
+ "category": "agent-in-3d",
+ "chain": "none",
+ "description": "Generative physics engine and simulation platform for robotics and embodied AI.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "habitat-lab",
+ "name": "Habitat-Lab",
+ "url": "https://github.com/facebookresearch/habitat-lab",
+ "repo": "https://github.com/facebookresearch/habitat-lab",
+ "category": "agent-in-3d",
+ "chain": "none",
+ "description": "Modular high-level library to train embodied AI agents across tasks and simulated 3D environments.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "mindcraft",
+ "name": "Mindcraft",
+ "url": "https://github.com/kolbytn/mindcraft",
+ "repo": "https://github.com/kolbytn/mindcraft",
+ "category": "agent-in-3d",
+ "chain": "none",
+ "description": "Minecraft agents driven by large language models, built on Mineflayer.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "mineflayer",
+ "name": "Mineflayer",
+ "url": "https://github.com/PrismarineJS/mineflayer",
+ "repo": "https://github.com/PrismarineJS/mineflayer",
+ "category": "agent-in-3d",
+ "chain": "none",
+ "description": "JavaScript API for creating Minecraft bots that perceive and act in the world.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "unity-ml-agents",
+ "name": "Unity ML-Agents",
+ "url": "https://github.com/Unity-Technologies/ml-agents",
+ "repo": "https://github.com/Unity-Technologies/ml-agents",
+ "category": "agent-in-3d",
+ "chain": "none",
+ "description": "Unity toolkit that turns games and simulations into environments for training intelligent agents.",
+ "status": "active",
+ "added": "2026-10-10"
+ },
+ {
+ "id": "voyager",
+ "name": "Voyager",
+ "url": "https://github.com/MineDojo/Voyager",
+ "repo": "https://github.com/MineDojo/Voyager",
+ "category": "agent-in-3d",
+ "chain": "none",
+ "description": "Open-ended embodied agent in Minecraft driven by large language models.",
+ "status": "archived",
+ "added": "2026-10-10"
+ }
+]
diff --git a/hubs/awesome-embodied-agents/data/schema.json b/hubs/awesome-embodied-agents/data/schema.json
new file mode 100644
index 000000000..d3604fbd8
--- /dev/null
+++ b/hubs/awesome-embodied-agents/data/schema.json
@@ -0,0 +1,22 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://github.com/awesome-embodied-agents/schema/entries.json",
+ "title": "awesome-embodied-agents entries",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["id", "name", "url", "repo", "category", "chain", "description", "status", "added"],
+ "properties": {
+ "id": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+ "name": { "type": "string", "minLength": 1, "maxLength": 80 },
+ "url": { "type": "string", "format": "uri", "pattern": "^https?://" },
+ "repo": { "type": ["string", "null"], "format": "uri", "pattern": "^https?://" },
+ "category": { "type": "string", "description": "An id from data/categories.json" },
+ "chain": { "type": "string", "description": "none unless the project is onchain", "default": "none" },
+ "description": { "type": "string", "minLength": 10, "maxLength": 160 },
+ "status": { "enum": ["active", "early", "archived"] },
+ "added": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }
+ }
+ }
+}
diff --git a/hubs/awesome-embodied-agents/package.json b/hubs/awesome-embodied-agents/package.json
new file mode 100644
index 000000000..41d40f29a
--- /dev/null
+++ b/hubs/awesome-embodied-agents/package.json
@@ -0,0 +1,14 @@
+{
+ "name": "awesome-embodied-agents",
+ "version": "1.0.0",
+ "private": true,
+ "description": "A curated, PR-fed directory of embodied AI agents and 3D avatar tooling.",
+ "license": "CC0-1.0",
+ "type": "module",
+ "scripts": {
+ "validate": "node scripts/validate.mjs",
+ "build": "node scripts/build-readme.mjs",
+ "check": "node scripts/validate.mjs && node scripts/build-readme.mjs --check"
+ },
+ "engines": { "node": ">=18" }
+}
diff --git a/hubs/awesome-embodied-agents/scripts/build-readme.mjs b/hubs/awesome-embodied-agents/scripts/build-readme.mjs
new file mode 100644
index 000000000..5d478b11d
--- /dev/null
+++ b/hubs/awesome-embodied-agents/scripts/build-readme.mjs
@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+// Regenerates the entries section of README.md from data/*.json.
+// Usage: node scripts/build-readme.mjs [--check]
+import { readFileSync, writeFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const load = (f) => JSON.parse(readFileSync(join(root, 'data', f), 'utf8'));
+const entries = load('entries.json');
+const categories = load('categories.json');
+
+const START = '<!-- ENTRIES:START -->';
+const END = '<!-- ENTRIES:END -->';
+const esc = (s) => String(s).replace(/\|/g, '\\|');
+const slug = (t) =>
+ t
+ .toLowerCase()
+ .replace(/[^a-z0-9 -]/g, '')
+ .trim()
+ .replace(/ /g, '-');
+const key = (e) => e.name.toLowerCase();
+
+const out = [];
+for (const cat of categories) {
+ const list = entries.filter((e) => e.category === cat.id).sort((a, b) => (key(a) < key(b) ? -1 : key(a) > key(b) ? 1 : 0));
+ out.push(`### ${cat.title}`, '', cat.blurb, '');
+ if (!list.length) {
+ out.push('No projects listed yet. [Add the first one](CONTRIBUTING.md).', '');
+ continue;
+ }
+ out.push('| Project | Description | Source | Status |', '| --- | --- | --- | --- |');
+ for (const e of list) {
+ const src = e.repo ? `[repo](${e.repo})` : '';
+ out.push(`| [${esc(e.name)}](${e.url}) | ${esc(e.description)} | ${src} | ${e.status} |`);
+ }
+ out.push('');
+}
+const block = `${START}\n\n${out.join('\n').trimEnd()}\n\n${END}`;
+
+const index = categories
+ .map((c) => `- [${c.title}](#${slug(c.title)}) (${entries.filter((e) => e.category === c.id).length})`)
+ .join('\n');
+const IS = '<!-- INDEX:START -->';
+const IE = '<!-- INDEX:END -->';
+
+const path = join(root, 'README.md');
+let readme = readFileSync(path, 'utf8');
+const replaceBlock = (text, s, e, body) => {
+ const a = text.indexOf(s);
+ const b = text.indexOf(e);
+ if (a === -1 || b === -1 || b < a) {
+ console.error(`README.md is missing the ${s} ... ${e} markers`);
+ process.exit(1);
+ }
+ return text.slice(0, a) + body + text.slice(b + e.length);
+};
+const next = replaceBlock(replaceBlock(readme, START, END, block), IS, IE, `${IS}\n\n${index}\n\n${IE}`);
+
+if (process.argv.includes('--check')) {
+ if (next !== readme) {
+ console.error('README.md is out of date. Run: node scripts/build-readme.mjs');
+ process.exit(1);
+ }
+ console.log('README.md is up to date.');
+} else {
+ writeFileSync(path, next);
+ console.log(`README.md updated: ${entries.length} entries in ${categories.length} categories.`);
+}
diff --git a/hubs/awesome-embodied-agents/scripts/validate.mjs b/hubs/awesome-embodied-agents/scripts/validate.mjs
new file mode 100644
index 000000000..b82d628ef
--- /dev/null
+++ b/hubs/awesome-embodied-agents/scripts/validate.mjs
@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+// Dependency-free validator for data/entries.json.
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const load = (f) => JSON.parse(readFileSync(join(root, 'data', f), 'utf8'));
+
+const errors = [];
+const err = (msg) => errors.push(msg);
+
+let entries;
+let categories;
+try {
+ entries = load('entries.json');
+ categories = load('categories.json');
+} catch (e) {
+ console.error(`Cannot read data files: ${e.message}`);
+ process.exit(1);
+}
+
+if (!Array.isArray(entries)) {
+ console.error('data/entries.json must be an array');
+ process.exit(1);
+}
+
+const categoryIds = new Set(categories.map((c) => c.id));
+if (categoryIds.size !== categories.length) err('categories.json has duplicate ids');
+
+const REQUIRED = ['id', 'name', 'url', 'repo', 'category', 'chain', 'description', 'status', 'added'];
+const STATUSES = new Set(['active', 'early', 'archived']);
+const DASHES = /[\u2013\u2014]/;
+const seen = new Set();
+
+const isUrl = (s) => {
+ if (typeof s !== 'string') return false;
+ try {
+ const u = new URL(s);
+ return u.protocol === 'https:' || u.protocol === 'http:';
+ } catch {
+ return false;
+ }
+};
+
+entries.forEach((e, i) => {
+ const at = `entry #${i + 1}${e && e.id ? ` (${e.id})` : ''}`;
+ if (!e || typeof e !== 'object') return err(`${at}: not an object`);
+ for (const k of REQUIRED) if (!(k in e)) err(`${at}: missing field "${k}"`);
+ for (const k of Object.keys(e)) if (!REQUIRED.includes(k)) err(`${at}: unknown field "${k}"`);
+ if (typeof e.id !== 'string' || !/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e.id)) err(`${at}: id must be kebab-case`);
+ else if (seen.has(e.id)) err(`${at}: duplicate id`);
+ else seen.add(e.id);
+ if (typeof e.name !== 'string' || !e.name.trim()) err(`${at}: name must be a non-empty string`);
+ if (!isUrl(e.url)) err(`${at}: url is not a valid http(s) URL`);
+ if (e.repo !== null && !isUrl(e.repo)) err(`${at}: repo must be a valid URL or null`);
+ if (!categoryIds.has(e.category)) err(`${at}: category "${e.category}" is not in categories.json`);
+ if (typeof e.chain !== 'string' || !e.chain) err(`${at}: chain must be a string ("none" unless onchain)`);
+ if (typeof e.description !== 'string') err(`${at}: description must be a string`);
+ else {
+ if (e.description.length < 10) err(`${at}: description is too short`);
+ if (e.description.length > 160) err(`${at}: description is ${e.description.length} chars, max 160`);
+ if (/\n/.test(e.description)) err(`${at}: description must be a single line`);
+ }
+ if (!STATUSES.has(e.status)) err(`${at}: status must be active, early or archived`);
+ if (typeof e.added !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(e.added) || Number.isNaN(Date.parse(e.added))) {
+ err(`${at}: added must be a valid YYYY-MM-DD date`);
+ }
+ for (const [k, v] of Object.entries(e)) {
+ if (typeof v === 'string' && DASHES.test(v)) err(`${at}: field "${k}" contains an em-dash or en-dash; use a comma, colon or hyphen`);
+ }
+});
+
+for (const c of categories) {
+ for (const [k, v] of Object.entries(c)) {
+ if (typeof v === 'string' && DASHES.test(v)) err(`category ${c.id}: field "${k}" contains an em-dash or en-dash`);
+ }
+}
+
+// Sorted alphabetically by name within each category.
+const key = (e) => String(e.name).toLowerCase();
+for (const cat of categories) {
+ const list = entries.filter((e) => e && e.category === cat.id);
+ for (let i = 1; i < list.length; i++) {
+ if (key(list[i - 1]) > key(list[i])) {
+ err(`category "${cat.id}": "${list[i].name}" must come before "${list[i - 1].name}" (sort alphabetically by name)`);
+ }
+ }
+}
+
+if (errors.length) {
+ console.error(`Validation failed with ${errors.length} problem${errors.length === 1 ? '' : 's'}:\n`);
+ for (const m of errors) console.error(` - ${m}`);
+ process.exit(1);
+}
+console.log(`OK: ${entries.length} entries across ${categories.length} categories.`);