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 * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';
import * as logs from 'aws-cdk-lib/aws-logs';
import * as lambda from 'aws-cdk-lib/aws-lambda';
import * as path from 'path';
import { Construct } from 'constructs';
export class ThreeWsStack extends cdk.Stack {
constructor(scope: Construct, id: string, props?: cdk.StackProps) {
super(scope, id, props);
// Avatar asset bucket — used by api/_lib/r2.js for 3D avatar uploads
const avatarBucket = new s3.Bucket(this, 'AvatarBucket', {
bucketName: '3d-agent-avatars',
versioned: false,
encryption: s3.BucketEncryption.S3_MANAGED,
blockPublicAccess: new s3.BlockPublicAccess({
blockPublicAcls: true,
blockPublicPolicy: true,
ignorePublicAcls: true,
restrictPublicBuckets: false, // CDN serves public reads via CloudFront/R2 domain
}),
cors: [
{
allowedMethods: [s3.HttpMethods.GET, s3.HttpMethods.PUT, s3.HttpMethods.HEAD],
allowedOrigins: ['https://three.ws', 'https://*.three.ws', 'http://localhost:3000'],
allowedHeaders: ['*'],
exposedHeaders: ['ETag'],
maxAge: 3000,
},
],
lifecycleRules: [
{
id: 'expire-tmp',
prefix: 'tmp/',
expiration: cdk.Duration.days(1),
},
],
removalPolicy: cdk.RemovalPolicy.RETAIN,
});
// CloudWatch log group for API-level observability (Vercel forwards structured logs here)
new logs.LogGroup(this, 'ApiLogGroup', {
logGroupName: '/three-ws/api',
retention: logs.RetentionDays.ONE_MONTH,
removalPolicy: cdk.RemovalPolicy.RETAIN,
});
// ── three.ws Forge — generative 3D sculptures + AR sharing ───────────────
// Zero-dependency Node Lambda. Serves per-seed share pages with real AR
// (iOS AR Quick Look / Android Scene Viewer via <model-viewer>) and Open
// Graph / Twitter Card meta, a binary-GLB API, and a hand-rendered PNG
// preview (software rasterizer) for link unfurls. Exposed via a Lambda
// Function URL — no API Gateway needed. Source: infra/lambda/forge.
const forgeLogGroup = new logs.LogGroup(this, 'ForgeLogGroup', {
logGroupName: '/aws/lambda/three-ws-forge',
retention: logs.RetentionDays.ONE_MONTH,
removalPolicy: cdk.RemovalPolicy.DESTROY,
});
const forgeFn = new lambda.Function(this, 'ForgeFn', {
functionName: 'three-ws-forge',
runtime: lambda.Runtime.NODEJS_22_X,
handler: 'index.handler',
code: lambda.Code.fromAsset(path.join(__dirname, '..', 'lambda', 'forge')),
memorySize: 1536, // headroom for mesh synthesis + software rasterizer
timeout: cdk.Duration.seconds(20),
architecture: lambda.Architecture.ARM_64,
description: 'three.ws Forge — generative 3D sculptures, GLB + AR + social cards',
logGroup: forgeLogGroup,
});
const forgeUrl = forgeFn.addFunctionUrl({
authType: lambda.FunctionUrlAuthType.NONE,
cors: {
allowedOrigins: ['*'],
allowedMethods: [lambda.HttpMethod.GET],
allowedHeaders: ['content-type'],
maxAge: cdk.Duration.hours(1),
},
});
new cdk.CfnOutput(this, 'ForgeUrl', {
value: forgeUrl.url,
description: 'Public URL for three.ws Forge — share pages, GLB API, AR, social cards',
});
// Associate this CloudFormation stack with the three.ws MyApplications entry.
// This surfaces all stack resources in the AWS MyApplications dashboard.
new cdk.CfnResource(this, 'AppRegistryAssociation', {
type: 'AWS::ServiceCatalogAppRegistry::ResourceAssociation',
properties: {
Application: 'arn:aws:servicecatalog:us-east-1:155407237916:/applications/03adso8olrmj6rbu0wvadul7ih',
Resource: cdk.Aws.STACK_ID,
ResourceType: 'CFN_STACK',
},
});
new cdk.CfnOutput(this, 'AvatarBucketName', { value: avatarBucket.bucketName });
new cdk.CfnOutput(this, 'AvatarBucketArn', { value: avatarBucket.bucketArn });
}
}