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
// Forge — Material restyle panel (browser client).
//
// Re-skins the current model's PBR materials without touching its geometry:
// "make it chrome", "wooden", "cyberpunk neon" — a free-text instruction goes
// to POST /api/material-studio?action=restyle, which has IBM Granite propose
// PBR factors and re-exports the GLB server-side. Same backing endpoint the
// paid `restyle_material` MCP tool calls, so results here are the exact same
// pipeline agents get. Synchronous (no poll loop needed).
//
// Self-contained: builds its own button + panel off `forge:model-ready`, same
// pattern as forge-stylize.js and forge-rig.js.
const PRESET_CHIPS = [
{ label: 'Chrome', instruction: 'make it polished chrome' },
{ label: 'Brushed gold', instruction: 'make it brushed gold metal' },
{ label: 'Weathered wood', instruction: 'make it weathered natural wood' },
{ label: 'Cyberpunk neon', instruction: 'make it glossy black with cyberpunk neon accent trim' },
{ label: 'Marble', instruction: 'make it polished white marble' },
{ label: 'Rusted metal', instruction: 'make it rusted, worn metal' },
];
const actions = document.querySelector('#state-result .result-bar .actions');
const resultBar = document.getElementById('state-result');
const viewer = document.getElementById('viewer');
if (actions && resultBar && viewer) {
injectStyles();
const btn = document.createElement('button');
btn.type = 'button';
btn.className = 'btn btn-ghost';
btn.id = 'forge-materials-btn';
btn.setAttribute('aria-expanded', 'false');
btn.title = 'Restyle this model’s materials (AI PBR re-skin, keeps the same shape)';
btn.innerHTML = `
<svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
<path d="M12 19l7-7 3 3-7 7-3-3z" />
<path d="M18 13l-1.5-7.5L2 2l3.5 14.5L13 18l5-5z" />
<path d="M2 2l7.586 7.586" />
<circle cx="11" cy="11" r="2" />
</svg>
Restyle materials`;
const rigBtn = document.getElementById('forge-rig-btn');
const arBtn = document.getElementById('forge-irl-btn') || document.getElementById('forge-ar-btn');
const anchorAfter = rigBtn || arBtn;
if (anchorAfter && anchorAfter.parentNode === actions) {
anchorAfter.after(btn);
} else {
actions.appendChild(btn);
}
const panel = document.createElement('div');
panel.className = 'materials-panel is-hidden';
panel.id = 'materials-panel';
panel.innerHTML = `
<div class="materials-head">
<h3>Restyle materials</h3>
<p class="materials-sub">Keeps the same mesh, re-skins the surface. Pick a preset or describe your own.</p>
</div>
<div class="materials-chips" id="materials-chips" role="group" aria-label="Material presets"></div>
<form class="materials-form" id="materials-form">
<input
type="text"
id="materials-instruction"
maxlength="300"
placeholder="Describe a material, e.g. "make it iridescent soap-bubble glass""
aria-label="Describe a material"
/>
<button type="submit" class="btn" id="materials-apply">Apply</button>
</form>
<div class="materials-actions is-hidden" id="materials-result-actions">
<a class="btn btn-ghost" id="materials-download" download>Download restyled GLB</a>
<button type="button" class="btn btn-ghost" id="materials-revert">Revert to original</button>
</div>
<div class="materials-status" id="materials-status" role="status" aria-live="polite"></div>
`;
resultBar.after(panel);
const chipsHost = panel.querySelector('#materials-chips');
for (const p of PRESET_CHIPS) {
const chip = document.createElement('button');
chip.type = 'button';
chip.className = 'materials-chip';
chip.textContent = p.label;
chip.addEventListener('click', () => {
panel.querySelector('#materials-instruction').value = p.instruction;
runRestyle(p.instruction);
});
chipsHost.appendChild(chip);
}
const form = panel.querySelector('#materials-form');
const input = panel.querySelector('#materials-instruction');
const status = panel.querySelector('#materials-status');
const resultActions = panel.querySelector('#materials-result-actions');
const downloadLink = panel.querySelector('#materials-download');
const revertBtn = panel.querySelector('#materials-revert');
const applyBtn = panel.querySelector('#materials-apply');
let originalGlbUrl = '';
let originalLabel = '';
let lastRestyledUrl = '';
let busy = false;
function setStatus(text, kind = '') {
status.textContent = text || '';
status.dataset.kind = kind;
}
function setBusy(next) {
busy = next;
applyBtn.disabled = next;
input.disabled = next;
for (const chip of chipsHost.querySelectorAll('.materials-chip')) chip.disabled = next;
}
async function runRestyle(instruction) {
const text = (instruction || '').trim();
if (!text || busy || !originalGlbUrl) return;
setBusy(true);
setStatus('Restyling materials…', 'busy');
try {
const res = await fetch('/api/material-studio?action=restyle', {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ glb_url: lastRestyledUrl || originalGlbUrl, instruction: text }),
});
const data = await res.json().catch(() => ({}));
if (res.status === 429) {
const secs = Number(data.retry_after) > 0 ? Math.ceil(Number(data.retry_after)) : 10;
setStatus(`Restyle is busy right now. Try again in about ${secs}s.`, 'error');
return;
}
if (!res.ok || !data.glbUrl) {
setStatus(data.message || `Restyle failed (${res.status}). Try a shorter, clearer description.`, 'error');
return;
}
lastRestyledUrl = data.glbUrl;
viewer.setAttribute('src', data.glbUrl);
viewer.setAttribute('alt', `${originalLabel} — restyled: ${text}`);
const safeLabel = (originalLabel || 'forge').replace(/[^a-z0-9]+/gi, '-').slice(0, 40).replace(/^-|-$/g, '') || 'forge';
downloadLink.href = data.glbUrl;
downloadLink.setAttribute('download', `${safeLabel}-restyled.glb`);
resultActions.classList.remove('is-hidden');
setStatus(`Applied: "${text}". Try another description, or revert.`, 'done');
} catch {
setStatus('Network hiccup — the model is unchanged. Try again.', 'error');
} finally {
setBusy(false);
}
}
form.addEventListener('submit', (e) => {
e.preventDefault();
runRestyle(input.value);
});
revertBtn.addEventListener('click', () => {
lastRestyledUrl = '';
viewer.setAttribute('src', originalGlbUrl);
viewer.setAttribute('alt', originalLabel || '3D model');
resultActions.classList.add('is-hidden');
setStatus('Showing the original materials.', '');
});
btn.addEventListener('click', () => {
const willShow = panel.classList.contains('is-hidden');
panel.classList.toggle('is-hidden', !willShow);
btn.setAttribute('aria-expanded', String(willShow));
if (willShow) input.focus();
});
function onNewSource(glbUrl, label) {
if (!glbUrl || glbUrl === originalGlbUrl) return;
originalGlbUrl = glbUrl;
originalLabel = label || '';
lastRestyledUrl = '';
resultActions.classList.add('is-hidden');
setStatus('', '');
input.value = '';
panel.classList.add('is-hidden');
btn.setAttribute('aria-expanded', 'false');
}
document.addEventListener('forge:model-ready', (e) => {
onNewSource(e.detail?.glbUrl, e.detail?.label);
});
const srcObserver = new MutationObserver(() => {
const url = viewer.getAttribute('src');
if (!url || url === originalGlbUrl || url === lastRestyledUrl) return;
onNewSource(url, document.getElementById('result-label')?.textContent?.trim() || '');
});
srcObserver.observe(viewer, { attributes: true, attributeFilter: ['src'] });
if (viewer.getAttribute('src')) {
onNewSource(viewer.getAttribute('src'), document.getElementById('result-label')?.textContent?.trim() || '');
}
}
function injectStyles() {
if (document.getElementById('forge-materials-styles')) return;
const style = document.createElement('style');
style.id = 'forge-materials-styles';
style.textContent = `
.materials-panel {
margin: 0 var(--space-md, 1rem) var(--space-md, 1rem);
padding: 0.9rem 1rem;
border: 1px solid var(--stroke);
border-radius: var(--radius-sm, 8px);
background: var(--surface, rgba(255,255,255,0.03));
}
.materials-panel.is-hidden { display: none; }
.materials-head h3 { margin: 0 0 0.15rem; font-size: var(--text-md, 1rem); }
.materials-sub { margin: 0 0 0.7rem; font-size: var(--text-sm, 0.85rem); color: var(--ink-dim); }
.materials-chips { display: flex; flex-wrap: wrap; gap: 0.4rem; margin-bottom: 0.7rem; }
.materials-chip {
padding: 0.35rem 0.7rem;
border: 1px solid var(--stroke);
border-radius: 999px;
background: transparent;
color: var(--ink);
font-size: var(--text-xs, 0.78rem);
cursor: pointer;
}
.materials-chip:hover:not(:disabled) { border-color: var(--accent); color: var(--accent); }
.materials-chip:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
.materials-chip:disabled { opacity: 0.5; cursor: progress; }
.materials-form { display: flex; gap: 0.5rem; }
.materials-form input {
flex: 1;
padding: 0.5rem 0.7rem;
border: 1px solid var(--stroke);
border-radius: var(--radius-sm, 8px);
background: transparent;
color: var(--ink);
font-size: var(--text-sm, 0.85rem);
}
.materials-form input:focus-visible { outline: 2px solid var(--accent); outline-offset: 1px; }
.materials-actions { display: flex; gap: 0.5rem; margin-top: 0.6rem; }
.materials-status { margin-top: 0.5rem; font-size: var(--text-xs, 0.8rem); color: var(--ink-dim); min-height: 1em; }
.materials-status[data-kind='error'] { color: var(--danger); }
.materials-status[data-kind='done'] { color: var(--success); }
`;
document.head.appendChild(style);
}