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
/**
* Hub status checks for /demo/avatar-os.
* Probes each dependency the demos rely on and reports whether it's reachable.
*/
const set = (id, msg, kind) => {
const el = document.getElementById(id);
if (!el) return;
el.textContent = msg;
el.classList.remove('ok', 'err');
if (kind === 'ok') el.classList.add('ok');
if (kind === 'err') el.classList.add('err');
};
async function probeMediapipe() {
try {
const mod = await import('@mediapipe/tasks-vision');
if (!mod.FaceLandmarker || !mod.FilesetResolver) {
throw new Error('FaceLandmarker not exported');
}
set('mp-status', `loaded · FaceLandmarker available`, 'ok');
} catch (err) {
set('mp-status', `failed: ${err.message}`, 'err');
}
}
async function probeTriangulation() {
try {
const mod = await import('./triangulation.js');
const arr = mod.TRIANGULATION;
if (!Array.isArray(arr)) throw new Error('TRIANGULATION not an array');
set('tri-status', `${arr.length} indices · ${arr.length / 3} triangles`, 'ok');
} catch (err) {
set('tri-status', `failed: ${err.message}`, 'err');
}
}
async function probeBaseGlb() {
try {
const res = await fetch('/avatars/default.glb', { method: 'HEAD' });
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const size = res.headers.get('content-length');
set(
'glb-status',
`/avatars/default.glb · ${size ? `${(size / 1024).toFixed(0)} KB` : 'ok'}`,
'ok',
);
} catch (err) {
set('glb-status', `failed: ${err.message}`, 'err');
}
}
// Same resolution as getStudioUrl() in src/avatar-creator.js: an explicit
// VITE_CHARACTER_STUDIO_URL override wins; otherwise the Avatar Studio is
// served same-origin under /avatar-studio in dev (Vite middleware) and prod
// (copy-avatar-studio build step) — never a dead localhost in production.
function resolveStudioUrl() {
try {
const override = import.meta.env?.VITE_CHARACTER_STUDIO_URL;
if (override) return String(override).trim().replace(/\/$/, '');
} catch (_) {}
return `${location.origin}/avatar-studio`;
}
async function probeAvatarStudio() {
const url = resolveStudioUrl();
const sameOrigin = url.startsWith(location.origin);
try {
const controller = new AbortController();
const timer = setTimeout(() => controller.abort(), 4000);
// A cross-origin override can't be inspected without CORS, so fall back
// to an opaque no-cors probe there; same-origin gives a real status.
const res = await fetch(`${url}/`, {
method: 'GET',
mode: sameOrigin ? 'same-origin' : 'no-cors',
signal: controller.signal,
});
clearTimeout(timer);
if (sameOrigin && !res.ok) throw new Error(`HTTP ${res.status}`);
set('cs-status', `reachable · ${url}`, 'ok');
} catch (err) {
set(
'cs-status',
`not reachable · ${url} — build with: npm --prefix character-studio run build`,
'err',
);
}
}
probeMediapipe();
probeTriangulation();
probeBaseGlb();
probeAvatarStudio();