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
"""Smoke test for the served contract, run INSIDE the built image (it needs
torch, FastAPI, PIL, google-cloud-storage, and the vendored PartCrafter tree
on PYTHONPATH):
docker build -t model-partcrafter workers/model-partcrafter
docker run --rm model-partcrafter python3 test_app_contract.py
It needs no GPU, no weights, and no GCP credentials: the ASGI lifespan (which
opens the GCS client and starts the model load) is deliberately not run, so
every assertion below is about request handling, not inference.
What it proves:
1. The whole app module imports.
2. The auth boundary rejects a wrong bearer on both authenticated routes.
3. The unauthenticated probes (/ and /health) answer, and a dead pipeline
says so on both /health and /infer so the caller fails over.
4. Request validation rejects an empty/oversized images array and an
out-of-range num_parts.
5. The image decoder refuses everything the SSRF guard should refuse.
"""
from __future__ import annotations
import base64
import io
import os
import sys
os.environ.setdefault("API_KEY", "smoke-test-key")
os.environ.setdefault("GCS_BUCKET", "smoke-test-bucket")
KEY = os.environ["API_KEY"]
PASSED = 0
def check(name: str, condition: bool, detail: str = "") -> None:
global PASSED
if not condition:
print(f"FAIL {name} {detail}")
sys.exit(1)
PASSED += 1
print(f"ok {name}")
def png_data_uri(color=(20, 20, 20, 255), size=(24, 24)) -> str:
from PIL import Image
img = Image.new("RGBA", size, color)
buf = io.BytesIO()
img.save(buf, format="PNG")
return "data:image/png;base64," + base64.b64encode(buf.getvalue()).decode()
def main() -> int:
import main as app_module
from fastapi.testclient import TestClient
client = TestClient(app_module.app)
bad = {"Authorization": "Bearer wrong-key"}
res = client.get("/tasks/does-not-exist", headers=bad)
check("GET /tasks rejects a wrong bearer", res.status_code == 401, f"got {res.status_code}")
res = client.post("/infer", headers=bad, json={"images": [png_data_uri()], "num_parts": 4})
check("POST /infer rejects a wrong bearer", res.status_code == 401, f"got {res.status_code}")
res = client.get("/health")
body = res.json()
check("GET /health answers 200", res.status_code == 200, f"got {res.status_code}")
check("health names the model", body.get("model") == "partcrafter", str(body)[:120])
res = client.get("/")
body = res.json()
check("GET / answers 200 for the keep-warm ping", res.status_code == 200, f"got {res.status_code}")
check("root names the service", body.get("service") == "model-partcrafter", str(body)[:120])
check("root lists the working endpoints", "POST /infer" in body.get("endpoints", []), str(body)[:160])
app_module._load_error = "internal error (ref deadbeefcafe)"
try:
res = client.get("/health")
body = res.json()
check("a dead pipeline makes /health answer 503", res.status_code == 503, f"got {res.status_code}")
check("a dead pipeline makes /health report ok:false", body.get("ok") is False, str(body)[:160])
check("health surfaces the load error", "deadbeefcafe" in str(body.get("load_error")), str(body)[:160])
res = client.post(
"/infer", headers={"Authorization": f"Bearer {KEY}"},
json={"images": [png_data_uri()], "num_parts": 4},
)
check("a dead pipeline makes /infer refuse with 503", res.status_code == 503, f"got {res.status_code}")
finally:
app_module._load_error = None
res = client.get("/health")
check("a live pipeline still answers /health 200", res.status_code == 200, f"got {res.status_code}")
check("a live pipeline reports ok:true", res.json().get("ok") is True, str(res.json())[:160])
good = {"Authorization": f"Bearer {KEY}"}
res = client.post("/infer", headers=good, json={"images": [], "num_parts": 4})
check("POST /infer rejects an empty images array", res.status_code == 422, f"got {res.status_code}")
res = client.post("/infer", headers=good, json={"images": [png_data_uri()] * 7, "num_parts": 4})
check("POST /infer rejects more than six images", res.status_code == 422, f"got {res.status_code}")
res = client.post("/infer", headers=good, json={"images": [png_data_uri()], "num_parts": 1})
check("POST /infer rejects num_parts below 2", res.status_code == 422, f"got {res.status_code}")
res = client.post("/infer", headers=good, json={"images": [png_data_uri()], "num_parts": 17})
check("POST /infer rejects num_parts above MAX_NUM_PARTS", res.status_code == 422, f"got {res.status_code}")
res = client.post("/infer", headers=good, json={"images": [png_data_uri()]})
check("POST /infer requires num_parts", res.status_code == 422, f"got {res.status_code}")
for label, src in [
("cleartext http", "http://example.com/a.png"),
("bare path", "/etc/passwd"),
("loopback https", "https://127.0.0.1/a.png"),
("cloud metadata", "https://169.254.169.254/latest/meta-data/"),
("corrupt data uri", "data:image/png;base64,not-base64!!"),
]:
try:
app_module._decode_image_bytes(src)
check(f"refuses {label}", False, "no exception raised")
except app_module.ImageSourceError:
check(f"refuses {label}", True)
except Exception as exc: # noqa: BLE001 - must be the caller-facing class
check(f"refuses {label}", False, f"raised {type(exc).__name__}: {exc}")
from pipeline import MAX_NUM_PARTS, _golden_ratio_color
check("MAX_NUM_PARTS matches upstream's own cap", MAX_NUM_PARTS == 16, str(MAX_NUM_PARTS))
c0 = _golden_ratio_color(0)
c1 = _golden_ratio_color(1)
check("golden-ratio colors are distinct per index", c0 != c1, f"{c0} vs {c1}")
check("golden-ratio colors are hex strings", c0.startswith("#") and len(c0) == 7, c0)
print(f"\n{PASSED} contract assertions passed")
return 0
if __name__ == "__main__":
sys.exit(main())