huangserva/3dcellforge

3D Model Studio, also published under the repository name 3DCellForge, is a React and Three.js prototype for turning uploaded reference images or GLB files into an interactive 3D workspace. It gives a user a three column layout: a model library on the left, a live WebGL stage in the center, and generation tools on the right, along with orbit controls, screenshots, and GLB export. The viewer is built with React Three Fiber and includes an inspector that reports a model's inferred category, source, provider, material focus, and tags, covering things like vehicles, aircraft, vessels, products, and organic specimens. Generated models get a quality score based on file size, triangle count, texture count, and readiness for demonstration. A dedicated demo mode hides side panels and switches to a cinematic camera path chosen by the type of object, useful for recording screenshots or videos. Generated and imported models persist across page refreshes through IndexedDB, with local storage as a smaller fallback, and a library drawer lets a user browse past generations, compare them, and delete the ones no longer needed. For turning images into 3D models, the project supports several optional backend providers: Hyper3D Rodin, Tripo, Fal.ai, and a locally hosted Hunyuan3D server, plus a fallback mode that generates a relief effect directly in the browser without any external service. An automatic mode tries these providers in order until one succeeds. All provider API keys are kept server side in a local environment file and are never exposed to the frontend code. The project ships with cached demo GLB files so it can be tried without spending API credits, plus a small set of externally licensed reference models from the Khronos sample model collection used for checking materials and loaders. Running it locally requires Node and npm, starting both a frontend Vite server and a small Node backend. It is released under the MIT license.