复刻了大神@DilumSanjaya的视觉框架，建了一个 F-22、F -35、星舰、猛禽发动机的展示网页。主要有 3 步： 1、使用 GPT 2 Image 生成模型三视图， 2、然后在 ComfyUI 里使用 Hunyuan 3.1生成对应的模型， 3、把大神@servasyy_ai开源的仓库丢给 Codex，然后换个SpaceX 网站的风格就可以了。 https://github.com/huangserva/3DCellForge… 非常轻松就可以搞定了

huangserva/3DCellForge

Source: https://github.com/huangserva/3DCellForge

3DCellForge

English | 中文

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.

Demo

Open the demo video: 3DCellForge-demo-2026-05-10.mp4

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.
• Auxiliary Khronos glTF reference models for GLB loader and PBR material checks.
• 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
RODIN_API_KEY=your_rodin_api_key
API_HOST=127.0.0.1

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

HUNYUAN_API_BASE=http://127.0.0.1:8081
HUNYUAN_CREATE_PATH=/send
HUNYUAN_STATUS_PATH=/status

The 3D generation backend supports these provider paths:

Tripo   Tripo cloud generation only (default)
Rodin   Hyper3D Rodin cloud generation only
Auto    Tripo first, then Rodin and Hunyuan backup
Hunyuan Local Hunyuan3D generation only

The upload panel exposes the full generation mode choice before picking a file:

Tripo       Tripo cloud GLB generation
Rodin       Hyper3D Rodin GLB generation
Hunyuan     Local Hunyuan3D GLB generation
JS Depth    Browser-side image relief with layered PNG fallback
Auto        Tripo, Rodin, Hunyuan, then JS Depth fallback
Local GLB   Import an existing .glb or self-contained .gltf

Tripo uploads use the current STS object-storage flow (/upload/sts/token) before creating an image_to_model task. Rodin uploads use Hyper3D’s multipart /rodin task API, then poll /status and cache the GLB returned by /download. Generated GLBs are cached by the Node backend under .generated-models/, so later views use the local copy instead of the temporary Tripo URL.

You can also import a local .glb or self-contained .gltf from the Microscope View add button. Imported models become custom Cell Types and are served from the same local cache.

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 http://127.0.0.1:8787 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.

Reference Models

The Library panel includes remote Khronos glTF Sample Models as auxiliary references for material and loader checks:

• Transmission Test, CC0, Adobe via Khronos.
• Transmission Roughness Test, CC-BY 4.0, Ed Mackey / Analytical Graphics via Khronos.
• Mosquito In Amber, CC-BY 4.0, Loic Norgeot / Geoffrey Marchal / Sketchfab via Khronos.

These are loaded from the archived Khronos sample repository and are not bundled into this repo.

Security

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

License

MIT