HTML explainer artifact
3DCellForge
Source: https://github.com/huangserva/3DCellForge
Generated: 2026-05-22T06:48:30Z
What this is
3DCellForge is a GitHub repo for an AI-assisted 3D model studio: upload a reference image or import a GLB/GLTF, generate or inspect a model, then present it in a polished WebGL workspace. It is not just a model generator wrapper; the repo is closer to a productized demo/inspection bench for image-to-3D outputs.
Link type + source signals
- Type: GitHub repository / prototype app.
- Stack: React + Vite, Three.js, React Three Fiber/Drei, Framer Motion, Node server APIs.
- License: MIT.
- Maturity signal at capture: about 2.3k stars, 381 forks, 2 open issues, created May 2026, last pushed May 16 2026.
- Useful caveat: young repo with strong demo traction; evaluate architecture and UX patterns before treating it as production infrastructure.
Source map
frontend studio
src/App.jsx main workspace orchestration
src/components/LeftSidebar.jsx model library + generation queue surfaces
src/components/CenterStage.jsx WebGL stage wrapper
src/viewer/CellViewer.jsx Three.js / React Three Fiber viewer
src/components/WorkspaceDrawer.jsx full asset catalog and comparison
src/lib/modelQuality.js demo-readiness scoring
src/lib/motionProfiles.js object-aware demo camera paths
src/domain/cellPersistence.js IndexedDB/localStorage persistence
backend adapters
server.mjs local API entrypoint
server/providers/rodin.mjs Hyper3D Rodin integration
server/providers/tripo.mjs Tripo upload/task flow
server/providers/fal.mjs Fal queue generation
server/providers/hunyuan.mjs local Hunyuan3D API bridge
server/providers/vision.mjs optional image understanding
server/model-store.mjs generated GLB cache
tests / proof
test/*.test.mjs Node unit tests for quality/metadata/server utils
test/visual/workbench.visual.spec Playwright visual regressions
docs/demo/*.mp4/.jpg product demo assets
Workflow the app enables
1. Start with a reference image or local GLB/GLTF.
2. Choose a provider: Hyper3D Rodin, Tripo, Fal models, local Hunyuan3D, browser JS Depth, Auto fallback, or local import.
3. Backend keeps provider API keys server-side and caches generated GLBs locally.
4. Frontend restores imported/generated assets with IndexedDB, exposes a model library, and gives each model metadata, status, quality score, and demo readiness.
5. Presentation mode hides workbench chrome and uses object-aware camera motions for screenshot/video capture.
What is worth stealing
- The “generation bench” pattern: queue + active asset + saved assets + inspector beats a plain upload form.
- Provider abstraction: one UI can route through multiple 3D-generation backends while keeping secrets server-side.
- Demo-readiness scoring: file size, triangle count, texture count, and object metadata become a go/no-go card before recording.
- Object-aware presentation paths: cars, aircraft, ships, organic/specimen objects get different camera choreography.
- Local cache + IndexedDB survival: important for Dab-created demos where generated provider URLs may expire.
Fit for Ananth / Dab workflows
- Good seed for a future “Dab can turn a sketch/image into an inspectable 3D artifact” workflow.
- Useful architecture reference for Mission Control project artifacts that need rich browser demos rather than static notes.
- Could pair with a Printing Press-style generator: Dab takes a prompt/reference image, runs a provider, stores GLB + explainer, and produces a shareable inspection page.
- Also useful as a UI reference for any multimodal pipeline where generated outputs need comparison, quality scoring, and presentation mode.
Best consumption path
- Skim README sections: Features, Workbench Workflow, Optional Image-to-3D Backend.
- Watch the demo video if deciding whether the UX pattern is worth copying.
- Inspect
server/providers/*for provider API shape andsrc/lib/modelQuality.js/src/lib/motionProfiles.jsfor reusable product logic. - Only clone/run if actively building a 3D artifact pipeline; otherwise the main value is the architecture and UI pattern.