3DCellForge

AI-powered interactive 3D cell generation and exploration studio.

3DCellForge is a React + Three.js prototype for exploring biological cell models in a polished browser UI. It supports live WebGL orbit controls, organelle panels, screenshots, GLB export, and optional image-to-3D providers for generating real 3D models from uploaded reference images.

Features

• Interactive cell viewer built with React Three Fiber.
• Drag to rotate, scroll to zoom, and toggle 3D proof mode.
• Organelle detail cards, microscope references, comparison panel, notes, and gallery actions.
• Tripo cloud image-to-3D pipeline through a local Node backend.
• Hunyuan3D local provider support as a backup generation path.
• Cached demo GLB models for offline-friendly screenshots and demos.
• API key stays server-side in .env.local; it is never exposed to the frontend bundle.

Tech Stack

• React
• Vite
• Three.js
• React Three Fiber
• Drei
• Framer Motion
• Tripo API optional backend
• Hunyuan3D local API optional backend

Quick Start

npm install
npm run dev

Open the Vite URL shown in the terminal.

Optional Image-to-3D Backend

To enable image-to-3D generation, create .env.local:

cp .env.example .env.local

Then set:

TRIPO_API_KEY=your_tripo_key

For Hunyuan3D local backup mode, start your local Hunyuan3D API server and set:

HUNYUAN_API_BASE=
HUNYUAN_CREATE_PATH=/send
HUNYUAN_STATUS_PATH=/status

The app supports three provider modes in Settings:

Tripo   Cloud generation only (default)
Auto    Tripo first, Hunyuan backup
Hunyuan Local Hunyuan3D generation only

Expected Hunyuan3D local API shape:

POST /send
GET  /status/:uid

The status response can return either a remote model URL or a base64 GLB field such as model_base64 / glb_base64. Base64 GLBs are cached under .generated-models/ and served by the Node backend.

Start the backend:

npm run dev:api

Then start the frontend:

npm run dev

The frontend talks to the local Node backend at ` by default.

Demo Models

The repository includes cached generated GLB files under:

public/generated-models/

These make the demo usable without spending API credits on every run.

Security

Do not put real API keys in frontend code. Keep secrets in .env.local, which is ignored by git.

License

MIT