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
"""Storage primitives for the standalone TRELLIS container.
Production persists tasks and results in GCS because requests can move between
Cloud Run instances. An NGC user runs one container with a mounted output
volume, so the same service needs a local backend with atomic writes and strict
task-id validation.
"""
from __future__ import annotations
import json
import os
import uuid
from pathlib import Path
def normalize_task_id(task_id: str) -> str:
"""Return a canonical UUID or reject a value that could escape the volume."""
parsed = uuid.UUID(task_id)
canonical = str(parsed)
if task_id.lower() != canonical:
raise ValueError("task_id must be a canonical UUID")
return canonical
class LocalStorage:
"""Durable task metadata and GLB results on a mounted local volume."""
def __init__(self, output_dir: str | os.PathLike[str]):
self.output_dir = Path(output_dir).expanduser().resolve()
self.tasks_dir = self.output_dir / "tasks"
self.results_dir = self.output_dir / "results"
self.tasks_dir.mkdir(parents=True, exist_ok=True)
self.results_dir.mkdir(parents=True, exist_ok=True)
def task_path(self, task_id: str) -> Path:
return self.tasks_dir / f"{normalize_task_id(task_id)}.json"
def result_path(self, task_id: str) -> Path:
return self.results_dir / f"{normalize_task_id(task_id)}.glb"
@staticmethod
def _atomic_write(path: Path, data: bytes) -> None:
temporary = path.with_suffix(path.suffix + ".tmp")
with temporary.open("wb") as handle:
handle.write(data)
handle.flush()
os.fsync(handle.fileno())
temporary.replace(path)
def write_task(self, task: dict) -> Path:
path = self.task_path(str(task["task_id"]))
payload = json.dumps(task, separators=(",", ":"), sort_keys=True).encode("utf-8")
self._atomic_write(path, payload)
return path
def read_task(self, task_id: str) -> dict:
return json.loads(self.task_path(task_id).read_text(encoding="utf-8"))
def write_result(self, task_id: str, glb_bytes: bytes) -> Path:
path = self.result_path(task_id)
self._atomic_write(path, glb_bytes)
return path