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 gallery — durable text→3D creations.
*
* GET /api/forge-gallery → { creations: [...], enabled }
* GET /api/forge-gallery?scope=community → { creations: [...], enabled }
*
* Default scope reads the persisted models for the browser identified by the
* x-forge-client header, newest first — the "Your creations" strip on /forge,
* so generated meshes are reusable instead of lost the moment the tab closes.
*
* scope=community reads the newest finished models across all clients (no
* client header required, nothing identifying returned) — the public "Fresh
* from the Forge" showcase. Community responses are CDN-cached briefly: the
* feed only changes when someone finishes a generation.
*
* When persistence isn't configured on the deployment both scopes return
* { enabled: false, creations: [] } so the page can hide the strips cleanly
* rather than show a broken state.
*/
import { cors, json, method, wrap, rateLimited, varyOn } from './_lib/http.js';
import { limits, clientIp } from './_lib/rate-limit.js';
import { hashClient, listCreations, listShowcase, countShowcase, forgeStoreEnabled } from './_lib/forge-store.js';
export default wrap(async (req, res) => {
// Open CORS: this is a public, keyless, read-only feed of models people chose
// to publish, and it is the catalogue the standalone AR studio
// (npm: 3d-ar-studio) offers as its Community tab from whatever origin a
// developer embedded it on. Rate limiting below is the real control here.
if (cors(req, res, { origins: '*', methods: 'GET,OPTIONS' })) return;
if (!method(req, res, ['GET'])) return;
const rl = await limits.publicIp(clientIp(req));
if (!rl.success) {
return rateLimited(res, rl);
}
if (!forgeStoreEnabled()) {
return json(res, 200, { enabled: false, creations: [] });
}
const url = new URL(req.url, 'http://localhost');
const limit = Math.min(Math.max(Number(url.searchParams.get('limit')) || 24, 1), 50);
if ((url.searchParams.get('scope') || '').trim() === 'community') {
// Fresh (newest, visual-first) vs Top (Forge-Off board, most-voted). The
// `window=week` narrows Top to the current Forge-Off week.
const sort = (url.searchParams.get('sort') || '').trim() === 'top' ? 'top' : 'fresh';
const window = (url.searchParams.get('window') || '').trim() === 'week' ? 'week' : 'all';
// Resolve the caller's own voted-state per card when they send their
// forge id — the community feed carries no other identifying data, and a
// missing header just yields voted=false everywhere (anonymous read).
const rawClient = req.headers['x-forge-client'];
const hasClient = Array.isArray(rawClient) ? rawClient[0] : rawClient;
const voterKey = hasClient ? hashClient(hasClient) : null;
// `total` is the full community-model count (social proof), independent of
// the paginated slice. Cheap enough to run alongside the feed read.
const [creations, total] = await Promise.all([
listShowcase({ limit, sort, window, voterKey }),
countShowcase(),
]);
// Per-voter reads can't be shared across browsers, so only the anonymous
// (no client id) read is CDN-cacheable. A voted-state read is private.
//
// The body changes with x-forge-client, so the edge MUST key on it. Without
// this Vary the anonymous copy (cacheable for 60s + 300s stale) was served
// to browsers that DID send the header, so every card came back voted=false
// for a voter who had already liked it and the like button rendered the
// wrong state (confirmed live against three.ws before this fix). varyOn
// merges rather than replaces, so cors()'s `vary: origin` survives.
varyOn(res, 'x-forge-client');
const headers = voterKey
? { 'cache-control': 'private, no-store' }
: { 'cache-control': 'public, s-maxage=60, stale-while-revalidate=300' };
return json(res, 200, { enabled: true, creations, total, sort, window }, headers);
}
const rawClient = req.headers['x-forge-client'];
const clientKey = hashClient(Array.isArray(rawClient) ? rawClient[0] : rawClient);
const creations = await listCreations({ clientKey, limit });
return json(res, 200, { enabled: true, creations });
});