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
#!/usr/bin/env node
// Build @three-ws/avatar by copying the prebuilt CDN bundle out of the parent
// repo's dist-lib/ into this package's dist/. The CDN bundle is built by
// `npm run build:lib` at the root of the repo and is already self-contained
// (Three.js inlined, side-effectful custom-element registration on import).
//
// We do NOT re-bundle here — Vite has already produced a single ES module
// suitable for both browser <script type="module"> use and bundler consumption.
// All this script does is materialise that file as dist/index.mjs plus an
// empty stylesheet placeholder (kept for forward-compatibility with the
// "@three-ws/avatar/style.css" subpath import).
import { copyFileSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';
import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
const here = dirname(fileURLToPath(import.meta.url));
const repoRoot = resolve(here, '..');
const src = resolve(repoRoot, 'dist-lib', 'agent-3d.js');
if (!existsSync(src)) {
console.error(
'[avatar-sdk] dist-lib/agent-3d.js is missing — run `npm run build:lib` at the repo root first.',
);
process.exit(1);
}
const outDir = resolve(here, 'dist');
mkdirSync(outDir, { recursive: true });
copyFileSync(src, resolve(outDir, 'index.mjs'));
// Runtime modules published as their own subpaths. Both are dependency-free
// (no Three.js, no DOM), which is the whole reason they can ship this way: a
// consumer driving its own renderer wants the gesture vocabulary and the
// routine sequencer without pulling in a second WebGL context. `choreography`
// imports `animation-slots` by relative path, so they travel together.
const runtimeDir = resolve(outDir, 'runtime');
mkdirSync(runtimeDir, { recursive: true });
for (const name of ['animation-slots.js', 'choreography.js']) {
const from = resolve(repoRoot, 'src', 'runtime', name);
if (!existsSync(from)) {
console.error(`[avatar-sdk] src/runtime/${name} is missing. Cannot publish the subpath.`);
process.exit(1);
}
copyFileSync(from, resolve(runtimeDir, name));
}
// Stylesheet stub. The custom element injects its own styles, so this is empty
// — but consumers that bundle ".css" side-effect imports get a no-op instead
// of a missing-file error.
writeFileSync(
resolve(outDir, 'style.css'),
'/* @three-ws/avatar — styles are injected by the custom element at runtime. */\n',
);
console.log('[avatar-sdk] built dist/index.mjs from dist-lib/agent-3d.js');