3DCellForge is an AI-powered, interactive studio for 3D model generation, inspection, and presentation. It targets developers and users needing a flexible workspace to transform reference images or GLB files into polished, interactive 3D assets, offering a streamlined workflow for creation and demonstration.

How It Works

Built with React and Three.js (via React Three Fiber), the application features a three-column layout: a model library, a central WebGL stage with live orbit controls, and a right-hand tools workbench. It employs an object-aware inspector that infers model categories and details, enhancing inspection. The core advantage lies in its integration with multiple optional image-to-3D providers, allowing generation from references, and a dedicated "Demo Mode" for polished presentations with cinematic camera paths.

Quick Start & Requirements

Install dependencies with npm install and run the development server using npm run dev. Key requirements include Node.js. Optional image-to-3D generation necessitates configuring API keys (e.g., TRIPO_API_KEY, FAL_API_KEY) in a .env.local file. A local Hunyuan3D API server is needed for that specific provider. The project includes cached demo GLB models for immediate use without API credits.

Highlighted Details

• Interactive 3D viewer powered by React Three Fiber with drag-to-rotate and zoom.
• Three-column UI: Model Library, WebGL Stage, Tools Workbench.
• Object-aware inspector identifies inferred categories, source, material focus, and tags.
• Model quality scoring based on file size, triangle count, and texture count.
• "Demo Mode" provides a clean presentation overlay with adaptive cinematic camera paths.
• Supports multiple generation providers: Hyper3D, Tripo, Fal.ai, Hunyuan3D, and JS Depth.
• Local caching of generated models (.generated-models/) and IndexedDB persistence for assets.
• Includes visual regression testing suite using Playwright (npm run test:visual).

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels like Discord or Slack.

Licensing & Compatibility

The project is released under the MIT license, which permits broad usage, including commercial applications and integration into closed-source projects.

Limitations & Caveats

Image-to-3D generation capabilities are optional and require external API key configuration. Certain providers, like Hunyuan3D, necessitate a separately running local API server. The README does not specify performance benchmarks beyond internal quality metrics.