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
import { LoadingManager, REVISION } from 'three';
export const DEFAULT_CAMERA = '[default]';
export const Preset = { ASSET_GENERATOR: 'assetgenerator' };
export const MANAGER = new LoadingManager();
const THREE_PATH = `https://unpkg.com/three@0.${REVISION}.x`;
// Decoder binaries. scripts/copy-three-decoders.mjs vendors them into
// public/three/ on every install and audit-deploy-artifacts.mjs fails a deploy
// that ships without them, so the same-origin copy is the reliable source and
// unpkg is only the backstop. Resolving against import.meta.url rather than a
// site-absolute path is what makes this correct inside a third-party
// <agent-3d> embed: the URL points at the origin serving this module (three.ws),
// not at the embedding page's origin, where /three/* would 404.
const LOCAL_THREE_PATH = (() => {
try {
return new URL('../../three/', import.meta.url).href.replace(/\/$/, '');
} catch {
return '/three';
}
})();
const localDecoderBase = () => ({
draco: `${LOCAL_THREE_PATH}/draco/gltf/`,
basis: `${LOCAL_THREE_PATH}/basis/`,
});
const cdnDecoderBase = () => ({
draco: `${THREE_PATH}/examples/jsm/libs/draco/gltf/`,
basis: `${THREE_PATH}/examples/jsm/libs/basis/`,
});
// PROBE_GRACE_MS is how long a model load is willing to wait for the verdict,
// not a deadline on the request itself. The probe runs to completion in the
// background with no abort signal: a HEAD that is merely slow (it competes with
// the three.js CDN downloads on a cold page and has been measured at 7s against
// production) is not evidence that public/three is missing, and aborting it both
// left a failed request in every viewer page's network log and demoted the
// same-origin decoders to unpkg for the rest of the session.
const PROBE_GRACE_MS = 1500;
// One probe, memoised only on a conclusive answer: does the vendored copy
// actually answer here? A stale deploy or a bundler that dropped public/three
// falls back to unpkg rather than failing every compressed model with an opaque
// decoder error. A network error leaves the question open, so the probe is
// cleared and the next model load asks again.
let _decoderBase = null;
let _decoderProbe = null;
function probeLocalDecoders() {
if (!_decoderProbe) {
_decoderProbe = fetch(`${LOCAL_THREE_PATH}/draco/gltf/draco_decoder.wasm`, { method: 'HEAD' })
.then((res) => { _decoderBase = res.ok ? localDecoderBase() : cdnDecoderBase(); })
.catch(() => { _decoderProbe = null; });
}
return _decoderProbe;
}
async function decoderBase() {
if (_decoderBase) return _decoderBase;
await Promise.race([
probeLocalDecoders(),
new Promise((resolve) => setTimeout(resolve, PROBE_GRACE_MS)),
]);
// Undecided within the grace window: the same-origin copy is what every
// deploy ships and what the artifact audit enforces, so start there. A
// conclusive 404 arriving later switches the next load to the mirror.
return _decoderBase || localDecoderBase();
}
/**
* Lazy, memoized setup of the Draco/KTX2/Meshopt decoders. Dynamically imports
* each module the first time a model is loaded, so the first-paint bundle does
* not pay for decoders that most callers never use.
*
* @returns {Promise<{ dracoLoader: DRACOLoader, ktx2Loader: KTX2Loader, meshoptDecoder: any }>}
*/
let _decodersPromise = null;
export function getDecoders() {
if (_decodersPromise) return _decodersPromise;
_decodersPromise = Promise.all([
import('three/addons/loaders/DRACOLoader.js'),
import('three/addons/loaders/KTX2Loader.js'),
import('three/addons/libs/meshopt_decoder.module.js'),
decoderBase(),
]).then(([dracoMod, ktx2Mod, meshoptMod, base]) => {
const dracoLoader = new dracoMod.DRACOLoader(MANAGER).setDecoderPath(base.draco);
const ktx2Loader = new ktx2Mod.KTX2Loader(MANAGER).setTranscoderPath(base.basis);
return { dracoLoader, ktx2Loader, meshoptDecoder: meshoptMod.MeshoptDecoder };
});
return _decodersPromise;
}
// Focused helper for viewers that only load avatars baked through the
// server-side pipeline. The bake emits EXT_meshopt_compression but never
// KHR_draco_mesh_compression or KTX2 textures (textureCompress targets WebP),
// so loading the heavier draco / ktx2 decoders would be wasted bytes.
let _meshoptDecoderPromise = null;
export function getMeshoptDecoder() {
if (_meshoptDecoderPromise) return _meshoptDecoderPromise;
_meshoptDecoderPromise = import('three/addons/libs/meshopt_decoder.module.js').then(
(m) => m.MeshoptDecoder,
);
return _meshoptDecoderPromise;
}
export function traverseMaterials(object, callback) {
const seen = new Set();
object.traverse((node) => {
if (!node.geometry) return;
const materials = Array.isArray(node.material) ? node.material : [node.material];
materials.forEach((mat) => {
if (mat && !seen.has(mat.uuid)) {
seen.add(mat.uuid);
callback(mat);
}
});
});
}