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 prompt studio — the text-mode authoring aids that sit under the
// composer: a combinatorial prompt generator behind "Surprise me" and
// "More ideas", a live prompt coach that grades what you typed against how
// the model actually reconstructs, and an honest character counter.
//
// All client-side. Prompts come from src/forge-prompt-gen.js: curated slot
// grammars whose every combination is a single isolated subject with a
// material/lighting cue (the shape Forge meshes cleanest), so the ideas are
// genuinely random without ever leaving the model's sweet spot. Nothing here
// fakes a network call.
import { generateDistinctForgePrompts, generateForgeChipSet } from './forge-prompt-gen.js';
const MAXLEN = 1000;
// Example chips stay scannable: only prompts short enough to read at a
// glance are seeded into chip UI ("Surprise me" uses the full range).
const CHIP_MAXLEN = 64;
const $ = (id) => document.getElementById(id);
const els = {
prompt: $('prompt'),
surprise: $('surprise'),
coach: $('prompt-coach'),
count: $('prompt-count'),
examples: $('examples'),
chipsMore: $('chips-more'),
emptyStarters: $('empty-starters'),
};
// Heuristic lexicons used by the coach. These describe how TRELLIS-style
// reconstruction behaves: a named material/finish and a clean isolated
// subject produce the sharpest mesh; scenes and multi-object prompts
// compress poorly into a single mesh.
const MATERIAL_WORDS = [
'metal',
'metallic',
'brass',
'bronze',
'copper',
'steel',
'iron',
'chrome',
'aluminium',
'aluminum',
'gold',
'silver',
'ceramic',
'porcelain',
'glazed',
'glass',
'crystal',
'wood',
'wooden',
'oak',
'leather',
'plastic',
'rubber',
'matte',
'glossy',
'polished',
'brushed',
'velvet',
'felt',
'stone',
'marble',
'granite',
'concrete',
'fabric',
'knit',
'enamel',
'carbon fibre',
'carbon fiber',
'bakelite',
'terracotta',
'weathered',
'rusted',
'patina',
'clay',
'obsidian',
'jade',
'wool',
'timber',
'sandstone',
'brick',
'cloth',
'linen',
];
const LIGHT_WORDS = ['studio', 'lighting', 'light', 'backlit', 'soft shadows', 'soft light', 'neutral'];
// Signals that the prompt is asking for a scene rather than one object.
const SCENE_WORDS = [
'scene',
'landscape',
'environment',
'diorama',
'room',
'interior',
'forest',
'city',
'street',
'battlefield',
'background of',
'surrounded by',
];
function hasAny(text, words) {
return words.some((w) => text.includes(w));
}
// Scene words need whole-word matching: substring matching flags innocent
// subjects ("mushroom" and "heirloom" both contain "room").
function hasSceneWord(text) {
return SCENE_WORDS.some((w) => new RegExp(`\\b${w}\\b`).test(text));
}
// Count subjects loosely — an " and " joining two nouns, or several
// comma-separated clauses, both push the model toward a multi-object mesh.
function looksMultiSubject(text) {
if (hasSceneWord(text)) return true;
if (/\b(two|three|four|several|a group of|a pair of|a set of)\b/.test(text)) return true;
// " x and y " where both sides carry a noun-ish token.
if (/\w+\s+and\s+\w+/.test(text) && !/black and white|red and white|salt and pepper/.test(text))
return true;
return false;
}
function grade(raw) {
const text = raw.trim().toLowerCase();
const words = text ? text.split(/\s+/).length : 0;
if (!text) {
return {
grade: 'tip',
msg: 'Name one object and a material, e.g. “a brass compass, weathered”.',
};
}
if (words < 2) {
return { grade: 'tip', msg: 'Add a little detail — a material, colour, or finish.' };
}
if (looksMultiSubject(text)) {
return {
grade: 'warn',
msg: 'One isolated object reconstructs cleanest — scenes and multiple subjects compress poorly.',
};
}
const material = hasAny(text, MATERIAL_WORDS);
const light = hasAny(text, LIGHT_WORDS);
if (material && light) {
return { grade: 'strong', msg: 'Strong prompt — clear subject, material and lighting cues.' };
}
if (material) {
return { grade: 'strong', msg: 'Good prompt — add “studio lighting” for an even cleaner bake.' };
}
return {
grade: 'tip',
msg: 'Add a material or finish — “matte ceramic”, “brushed brass” — for a sharper mesh.',
};
}
function updateCoach() {
if (!els.prompt) return;
const value = els.prompt.value;
if (els.coach) {
const { grade: g, msg } = grade(value);
els.coach.dataset.grade = g;
els.coach.textContent = msg;
}
if (els.count) {
const len = value.length;
els.count.textContent = `${len} / ${MAXLEN}`;
els.count.dataset.near = String(len >= MAXLEN - 100);
}
}
function surprise() {
if (!els.prompt) return;
const [pick] = generateDistinctForgePrompts(1, new Set([els.prompt.value.trim()]));
if (!pick) return;
els.prompt.value = pick;
updateCoach();
els.prompt.focus();
const end = els.prompt.value.length;
els.prompt.setSelectionRange(end, end);
els.surprise?.classList.remove('is-rolling');
// reflow so the animation restarts on rapid clicks
void els.surprise?.offsetWidth;
els.surprise?.classList.add('is-rolling');
}
// Write a generated prompt into a chip and take ownership of its text.
//
// The example rows in pages/forge.html deliberately carry no data-i18n keys
// (see the comment there), but a chip injected by another module might. i18n's
// applyCatalog walks [data-i18n] whenever a catalog loads or the locale
// changes and would write the original string back over the generated one,
// silently undoing every rotation and re-wrapping the flex row underneath it.
// Dropping the attribute hands the node to its real owner, the same way
// nav-auth's data-auth-name guard does in src/i18n.js.
function setChipPrompt(chip, text) {
chip.textContent = text;
chip.removeAttribute('data-i18n');
}
// The replacement labels for a chip row come from generateForgeChipSet, which
// fits them inside the row's existing character budget so a rotation can never
// add a wrapped line. See its comment in forge-prompt-gen.js for why the
// per-label CHIP_MAXLEN cap was not enough on its own.
const generateChipSet = (chips, avoid) =>
generateForgeChipSet(
chips.map((c) => c.textContent),
avoid,
Math.random,
CHIP_MAXLEN
);
// Hold the row at the height it already occupies while its labels change, so a
// set that happens to wrap onto fewer lines cannot shift the page upward
// either. Released on resize: a resize relayouts the whole page anyway, and a
// stale pin from a narrower viewport would leave a visible gap.
function pinRowHeight(container) {
if (!container) return;
const h = container.getBoundingClientRect().height;
if (!h) return;
container.style.minHeight = `${h}px`;
window.addEventListener(
'resize',
() => {
container.style.minHeight = '';
},
{ once: true }
);
}
function shuffleChips() {
if (!els.examples) return;
// Seasonal presets (.chip--festive) are pinned: "More ideas" only rotates
// the regular library chips, never overwrites the festive prompts.
const chips = [...els.examples.querySelectorAll('.chip:not(.chip--festive)')];
if (!chips.length) return;
const current = new Set(chips.map((c) => c.textContent.trim()));
pinRowHeight(els.examples);
const fresh = generateChipSet(chips, current);
chips.forEach((chip, i) => {
const next = fresh[i];
if (!next) return;
chip.classList.add('is-swapping');
});
const swap = () => {
chips.forEach((chip, i) => {
if (fresh[i]) setChipPrompt(chip, fresh[i]);
chip.classList.remove('is-swapping');
});
};
if (window.matchMedia?.('(prefers-reduced-motion: reduce)').matches) swap();
else setTimeout(swap, 180);
els.chipsMore?.classList.remove('is-rolling');
void els.chipsMore?.offsetWidth;
els.chipsMore?.classList.add('is-rolling');
}
// Every visit opens on a fresh random set; the static chip text in the HTML
// is only the no-JS fallback. Covers both the composer's example chips and
// the empty-stage starters, kept mutually distinct; festive (pinned
// seasonal) chips are untouched.
function seedChips() {
// Each row gets its own character budget: the two rows live in different
// columns and wrap independently, so pooling their budgets would let one
// spend the other's and re-introduce the wrap it was meant to prevent.
// `used` carries across both so the two rows stay mutually distinct.
const used = new Set();
for (const container of [els.examples, els.emptyStarters]) {
if (!container) continue;
const chips = [...container.querySelectorAll('.chip:not(.chip--festive)')];
if (!chips.length) continue;
// The height the row already occupies on screen. The character budget
// below aims to keep a swap inside it, but characters are not pixels in a
// proportional font, so one label that renders a few pixels wider still
// wrapped the row onto another line and pushed the rest of the page down:
// 0.20 of /forge's CLS, on every load, because this runs after first paint.
const baseline = container.getBoundingClientRect().height;
pinRowHeight(container);
const fresh = generateChipSet(chips, used);
chips.forEach((chip, i) => {
if (!fresh[i]) return;
const previous = chip.textContent;
setChipPrompt(chip, fresh[i]);
// Measured, not predicted: keep the fresh label only when the row is
// still the height it was. One reflow per chip, once, on a single row.
if (container.getBoundingClientRect().height > baseline + 0.5) {
setChipPrompt(chip, previous);
return;
}
used.add(fresh[i]);
});
}
}
if (els.prompt) {
els.prompt.addEventListener('input', updateCoach);
els.surprise?.addEventListener('click', surprise);
els.chipsMore?.addEventListener('click', shuffleChips);
seedChips();
// Reflect any value already present (remix ?prompt= prefill, restored draft).
updateCoach();
}