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
# gltfpack (zeux/meshoptimizer, MIT) decodes EXT_meshopt_compression, which
# trimesh cannot read and which most three.ws avatars ship as. Pinned by release
# tag and checksum so the image never picks up a binary we did not audit.
FROM python:3.11-slim AS gltfpack
ARG GLTFPACK_VERSION=v1.2
ARG GLTFPACK_SHA256=ebc236f5f6c08c7e5c5750476a187d24805d44d8c680449c4b7369c333f817b1
RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates curl unzip \
&& curl -fsSL -o /tmp/gltfpack.zip \
https://github.com/zeux/meshoptimizer/releases/download/${GLTFPACK_VERSION}/gltfpack-ubuntu.zip \
&& echo "${GLTFPACK_SHA256} /tmp/gltfpack.zip" | sha256sum -c - \
&& unzip -j /tmp/gltfpack.zip gltfpack -d /usr/local/bin \
&& chmod +x /usr/local/bin/gltfpack \
&& /usr/local/bin/gltfpack -v
FROM python:3.11-slim
ENV PYTHONDONTWRITEBYTECODE=1 \
PYTHONUNBUFFERED=1 \
PIP_NO_CACHE_DIR=1
COPY --from=gltfpack /usr/local/bin/gltfpack /usr/local/bin/gltfpack
# GL/OpenMP/BLAS runtime for open3d and trimesh. No libassimp: nothing in this
# image loads it (trimesh 4.x has no assimp loader, DAE input goes through
# pycollada, and FBX input is refused).
RUN apt-get update && apt-get install -y --no-install-recommends \
libgl1 libglib2.0-0 libgomp1 \
libopenblas-dev \
&& rm -rf /var/lib/apt/lists/*
COPY requirements.txt /app/requirements.txt
RUN pip install -r /app/requirements.txt
WORKDIR /app
# oin.py is the shared OIN protocol layer (specs/OPEN_INFERENCE_PROTOCOL.md),
# vendored into this directory exactly like worker_security.py: the build
# context is workers/stylize, so ../ is unreachable. Keep the copy byte-identical.
COPY worker_security.py /app/worker_security.py
COPY gltf_meshopt.py /app/gltf_meshopt.py
COPY oin.py /app/oin.py
COPY oin_upload.py /app/oin_upload.py
COPY main.py /app/main.py
COPY test_stylize.py /app/test_stylize.py
COPY test_gltf_meshopt.py /app/test_gltf_meshopt.py
# Build-time guard: the four filters, the color sampler, the export round-trip,
# the memory caps, the SSRF gate, and the upload retry policy must pass their
# unit suite or the image does not ship. This is also the only place open3d's
# decimation path (used by voronoi + lowpoly) and the gltfpack meshopt decode are
# exercised; the local run falls back to trimesh and skips the meshopt case.
RUN python /app/test_stylize.py && python /app/test_gltf_meshopt.py
EXPOSE 8080
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080", "--workers", "1"]