Skip to content

The all-in-one local AI studio for your desktop: chat, image and video generation and a coding agent in one free, open source app. Windows and Linux. No Docker, no terminal, no cloud required.

feat(create-3d): local 3D says before setup and run when the card is under 12 GB

purplecd30f5eaf6bc
diff --git a/e2e/create-3d-hardware-hint.spec.ts b/e2e/create-3d-hardware-hint.spec.ts
new file mode 100644
index 00000000..1285d82b
--- /dev/null
+++ b/e2e/create-3d-hardware-hint.spec.ts
@@ -0,0 +1,32 @@
+import { test, expect } from '@playwright/test'
+import { tauriMockInit, DEFAULT_ASSISTANT_REPLY, DEFAULT_MODEL_NAME } from './support/tauri-mock'
+import { seedOnboardingDone } from './support/cloud-mock'
+
+/**
+ * Local 3D on a PC with an 8 GB card (3.1.1, W40): the 3D tab says before the
+ * setup that TRELLIS.2 asks for 12 GB, in one line above the stage, and the
+ * setup stays offered. Anlass: an RX 6600 with 8 GB that waited long and then
+ * failed in a loader.
+ */
+test('an 8 GB card: the 3D tab says so before the setup, and the setup stays', async ({ page }) => {
+ await page.addInitScript(tauriMockInit, {
+ assistantReply: DEFAULT_ASSISTANT_REPLY,
+ modelName: DEFAULT_MODEL_NAME,
+ platform: 'windows',
+ invokeOverrides: {
+ detect_gpus: [{ index: 0, vendor: 'AMD', name: 'AMD Radeon RX 6600', memory_mib: 8192, source: 'registry' }],
+ },
+ })
+ await seedOnboardingDone(page)
+ await page.goto('/')
+ await page.getByRole('button', { name: /^Create$/ }).first().click()
+ await page.getByRole('radio', { name: /3D/ }).first().click()
+
+ const line = page.getByTestId('three-d-hardware')
+ await expect(line).toHaveText('Local 3D needs a graphics card with 12 GB or more. Yours has 8 GB.', { timeout: 15_000 })
+ await expect(page.getByTestId('three-d-hardware-cloud')).toHaveText('Use a LU Cloud 3D model instead.')
+ await expect(page.getByRole('heading', { name: 'Local 3D needs a one-time download' })).toBeVisible()
+ await expect(page.getByRole('heading', { name: /Local image generation/ })).toHaveCount(0)
+ await expect(page.getByRole('button', { name: 'Download & install' })).toBeEnabled()
+ await page.screenshot({ path: 'test-results/three-d-hardware-hint.png' })
+})
diff --git a/src/components/create/experimental/CreateExperimental.tsx b/src/components/create/experimental/CreateExperimental.tsx
index 84b281d1..39fdee79 100644
--- a/src/components/create/experimental/CreateExperimental.tsx
+++ b/src/components/create/experimental/CreateExperimental.tsx
@@ -25,6 +25,7 @@ import { WorkflowsModal } from '../WorkflowsModal'
import { Hinweis } from '../../ui/Hinweis'
import { BannerText } from './BannerText'
import { MacVideoMemoryNotice } from './MacVideoMemoryNotice'
+import { ThreeDHardwareNotice } from './ThreeDHardwareNotice'
import { CreateCloudOffer } from './CreateCloudOffer'
import { MaskEditor } from './MaskEditor'
import { VhsInstallModal } from './VhsInstallModal'
@@ -426,6 +427,11 @@ function CreateExperimentalInner() {
for. The run is not held back, so it is said before it starts. */}
<MacVideoMemoryNotice />
+ {/* Local 3D on a PC whose card is under TRELLIS.2's 12 GB, or with
+ ComfyUI on the processor: one line before setup and run, with the
+ way to LU Cloud 3D. A hint, the setup and the run stay possible. */}
+ <ThreeDHardwareNotice />
+
{/* The run on screen does not fit this machine (too big for the card,
only partly on it for a video, or a long Mac run): one quiet line
that LU Cloud runs it, closable for the session. */}
diff --git a/src/components/create/experimental/ThreeDHardwareNotice.tsx b/src/components/create/experimental/ThreeDHardwareNotice.tsx
new file mode 100644
index 00000000..746771d4
--- /dev/null
+++ b/src/components/create/experimental/ThreeDHardwareNotice.tsx
@@ -0,0 +1,56 @@
+// The line of the 3D tab for a PC whose card does not fit TRELLIS.2 (under
+// 12 GB, or ComfyUI on the processor), lib/three/three-d-hardware.ts. It
+// stands with the other quiet lines above the stage, so it is there before
+// the setup card and before a run alike. A hint, not a lock: the setup and
+// the Create button stay as they are. Not on a Mac.
+import { Cpu } from 'lucide-react'
+import { isMlxImageHost } from '../../../api/mlx-image'
+import { reportCloudGate } from '../../../api/funnel'
+import { useGraphicsCardGb } from '../../../hooks/useGraphicsMemory'
+import { THREE_D_USE_CLOUD, threeDHardwareLine } from '../../../lib/three/three-d-hardware'
+import { useCreateStore } from '../../../stores/createStore'
+import { useUIStore } from '../../../stores/uiStore'
+import { useCloudOfferAllowed } from '../../cloud/CloudOffer'
+import { Hinweis } from '../../ui/Hinweis'
+import { useCreateExp } from './CreateContext'
+
+export function ThreeDHardwareNotice() {
+ const intent = useCreateStore((s) => s.intent())
+ const backend = useCreateStore((s) => s.backend)
+ const setBackend = useCreateStore((s) => s.setBackend)
+ const setCloudGateOpen = useUIStore((s) => s.setCloudGateOpen)
+ const cardGb = useGraphicsCardGb()
+ const { comfyOnCpu, cloudAvailable } = useCreateExp()
+ const cloudAllowed = useCloudOfferAllowed()
+ if (intent !== '3d' || backend !== 'local' || isMlxImageHost()) return null
+ const line = threeDHardwareLine({ cardGb, comfyOnCpu })
+ if (!line) return null
+ const toCloud = () => {
+ // Signed in: the same tab in cloud mode. Otherwise the plans, as the
+ // other cloud offers in Create do.
+ if (cloudAvailable) {
+ setBackend('cloud')
+ return
+ }
+ reportCloudGate('cloud_offer_click')
+ setCloudGateOpen(true, 'cloud-offer')
+ }
+ return (
+ <Hinweis icon={<Cpu size={12} className="shrink-0 mt-px" />} className="px-4 py-2 shrink-0">
+ <span data-testid="three-d-hardware">{line}</span>
+ {cloudAllowed && (
+ <>
+ {' '}
+ <button
+ type="button"
+ onClick={toCloud}
+ data-testid="three-d-hardware-cloud"
+ className="inline font-medium text-lu-cloud dark:text-lu-cloud-lift hover:underline underline-offset-2"
+ >
+ {THREE_D_USE_CLOUD}
+ </button>
+ </>
+ )}
+ </Hinweis>
+ )
+}
diff --git a/src/components/create/experimental/ThreeDStage.tsx b/src/components/create/experimental/ThreeDStage.tsx
index 1f879cc6..b5795f7f 100644
--- a/src/components/create/experimental/ThreeDStage.tsx
+++ b/src/components/create/experimental/ThreeDStage.tsx
@@ -23,7 +23,7 @@ export const SETUP_TEXT = {
macTitle: '3D on this Mac needs a one-time download',
macBody: 'This sets up the 3D engine and the TripoSR model, about 1.7 GB. It turns one picture into a 3D model on this Mac. Local 3D is never filtered.',
pcTitle: 'Local 3D needs a one-time download',
- pcBody: 'This sets up ComfyUI itself if it is missing, plus the TRELLIS.2 model files, about 9 GB. Local 3D is never filtered.',
+ pcBody: 'This sets up ComfyUI itself if it is missing, plus the TRELLIS.2 model files, about 9 GB. It needs a graphics card with 12 GB or more. Local 3D is never filtered.',
sf3dTitle: 'Stable Fast 3D needs a one-time download',
sf3dBody: 'This sets up its own 3D engine and the Stable Fast 3D model, about 4 GB. It turns one picture into a 3D model with a painted texture, on this Mac.',
licenseLink: 'Open the model page',
diff --git a/src/components/create/experimental/__tests__/three-d-says-when-the-card-is-too-small.test.tsx b/src/components/create/experimental/__tests__/three-d-says-when-the-card-is-too-small.test.tsx
new file mode 100644
index 00000000..2685d5c7
--- /dev/null
+++ b/src/components/create/experimental/__tests__/three-d-says-when-the-card-is-too-small.test.tsx
@@ -0,0 +1,118 @@
+// @vitest-environment jsdom
+/**
+ * 3.1.1, the owner's wish W40 (17.11.2026): local 3D says before the setup and
+ * before a run when the PC does not fit TRELLIS.2. Anlass: an RX 6600 with 8 GB
+ * waited long and then got "DefaultCPUAllocator: not enough memory" from a
+ * loader. One quiet line, the way to LU Cloud 3D after it, setup and run stay
+ * possible. Not on a Mac.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { render, screen, cleanup, fireEvent } from '@testing-library/react'
+
+const env = vi.hoisted(() => ({ mac: false, cardGb: null as number | null, comfyOnCpu: false, cloudAvailable: false }))
+vi.mock('../../../../api/mlx-image', async (orig) => ({
+ ...(await orig<typeof import('../../../../api/mlx-image')>()),
+ isMlxImageHost: () => env.mac,
+}))
+vi.mock('../../../../hooks/useGraphicsMemory', () => ({ useGraphicsCardGb: () => env.cardGb }))
+vi.mock('../CreateContext', () => ({ useCreateExp: () => ({ comfyOnCpu: env.comfyOnCpu, cloudAvailable: env.cloudAvailable }) }))
+vi.mock('../../../../api/funnel', () => ({ reportCloudGate: vi.fn() }))
+
+import { ThreeDHardwareNotice } from '../ThreeDHardwareNotice'
+import { SETUP_TEXT } from '../ThreeDStage'
+import { threeDHardwareLine, TRELLIS_MIN_VRAM_GB } from '../../../../lib/three/three-d-hardware'
+import { useCreateStore, type CreateIntent } from '../../../../stores/createStore'
+import { useSettingsStore } from '../../../../stores/settingsStore'
+import { useUIStore } from '../../../../stores/uiStore'
+
+function show(intent: CreateIntent = '3d') {
+ useCreateStore.getState().setIntent(intent)
+ return render(<ThreeDHardwareNotice />)
+}
+const line = () => screen.queryByTestId('three-d-hardware')
+const cloud = () => screen.queryByTestId('three-d-hardware-cloud')
+
+beforeEach(() => {
+ Object.assign(env, { mac: false, cardGb: null, comfyOnCpu: false, cloudAvailable: false })
+ useSettingsStore.getState().updateSettings({ appMode: 'local', cloudTeasersEnabled: true })
+ useCreateStore.setState({ backend: 'local' })
+ useUIStore.setState({ cloudGateOpen: false })
+})
+afterEach(cleanup)
+
+describe('the sentence', () => {
+ it('names the card under 12 GB, and the processor', () => {
+ expect(TRELLIS_MIN_VRAM_GB).toBe(12)
+ expect(threeDHardwareLine({ cardGb: 8, comfyOnCpu: false })).toBe('Local 3D needs a graphics card with 12 GB or more. Yours has 8 GB.')
+ expect(threeDHardwareLine({ cardGb: 24, comfyOnCpu: true })).toBe('Local 3D needs a graphics card with 12 GB or more. ComfyUI runs on the processor here.')
+ })
+
+ it('says nothing for 12 GB and more, or while nothing is known', () => {
+ for (const cardGb of [12, 16, 24, null, 0]) expect(threeDHardwareLine({ cardGb, comfyOnCpu: false }), String(cardGb)).toBeNull()
+ })
+
+ it('the setup card names the 12 GB before the download', () => {
+ expect(SETUP_TEXT.pcBody).toContain('12 GB or more')
+ })
+})
+
+describe('the line in the 3D tab', () => {
+ it('an 8 GB card: the line and the way to LU Cloud 3D', () => {
+ env.cardGb = 8
+ show()
+ expect(line()?.textContent).toBe('Local 3D needs a graphics card with 12 GB or more. Yours has 8 GB.')
+ expect(cloud()?.textContent).toBe('Use a LU Cloud 3D model instead.')
+ })
+
+ it('signed in: the button turns the tab to the cloud', () => {
+ env.cardGb = 8
+ env.cloudAvailable = true
+ show()
+ fireEvent.click(cloud()!)
+ expect(useCreateStore.getState().backend).toBe('cloud')
+ expect(useUIStore.getState().cloudGateOpen).toBe(false)
+ })
+
+ it('not signed in: the button opens the plans', () => {
+ env.cardGb = 8
+ show()
+ fireEvent.click(cloud()!)
+ expect(useUIStore.getState().cloudGateOpen).toBe(true)
+ expect(useCreateStore.getState().backend).toBe('local')
+ })
+
+ it('ComfyUI on the processor, whatever the card', () => {
+ env.cardGb = 24
+ env.comfyOnCpu = true
+ show()
+ expect(line()?.textContent).toContain('ComfyUI runs on the processor here.')
+ })
+
+ it('cloud offers switched off: the line without the cloud', () => {
+ env.cardGb = 8
+ useSettingsStore.getState().updateSettings({ cloudTeasersEnabled: false })
+ show()
+ expect(line()).not.toBeNull()
+ expect(cloud()).toBeNull()
+ })
+
+ it('not for a card that fits, not on a Mac, not in the cloud, not in other tabs', () => {
+ env.cardGb = 12
+ show()
+ expect(line()).toBeNull()
+ cleanup()
+ env.cardGb = 8
+ env.mac = true
+ show()
+ expect(line()).toBeNull()
+ cleanup()
+ env.mac = false
+ useCreateStore.setState({ backend: 'cloud' })
+ show()
+ expect(line()).toBeNull()
+ cleanup()
+ useCreateStore.setState({ backend: 'local' })
+ show('image')
+ expect(line()).toBeNull()
+ })
+})
diff --git a/src/lib/three/three-d-hardware.ts b/src/lib/three/three-d-hardware.ts
new file mode 100644
index 00000000..62d6b5f3
--- /dev/null
+++ b/src/lib/three/three-d-hardware.ts
@@ -0,0 +1,33 @@
+// Local 3D on Windows and Linux runs TRELLIS.2 in ComfyUI, which asks for a
+// graphics card with 12 GB or more (measured on a 12 GB RTX 3060: Draft
+// peaked at 11.1 GB). Below that, or with ComfyUI on the processor, a run
+// loads for a long time and then fails in a loader ("DefaultCPUAllocator: not
+// enough memory", RX 6600 with 8 GB, Discord 17.11.2026). This line says so
+// before the setup and before a run. It is a hint, not a lock: setting up and
+// starting stay possible.
+//
+// A Mac is not asked here. TripoSR and Stable Fast 3D run on its shared
+// memory and have no measured limit.
+
+/** The graphics memory TRELLIS.2 asks for, in GB. */
+export const TRELLIS_MIN_VRAM_GB = 12
+
+export interface ThreeDHardwareFacts {
+ /** The card's own memory in whole GB, null while unknown or on a Mac. */
+ cardGb: number | null
+ /** ComfyUI runs on the processor this session. */
+ comfyOnCpu: boolean
+}
+
+/** The line for a machine that does not fit local 3D, or null when it fits
+ * or nothing is known yet. */
+export function threeDHardwareLine({ cardGb, comfyOnCpu }: ThreeDHardwareFacts): string | null {
+ if (comfyOnCpu) return `Local 3D needs a graphics card with ${TRELLIS_MIN_VRAM_GB} GB or more. ComfyUI runs on the processor here.`
+ if (cardGb !== null && cardGb > 0 && cardGb < TRELLIS_MIN_VRAM_GB) {
+ return `Local 3D needs a graphics card with ${TRELLIS_MIN_VRAM_GB} GB or more. Yours has ${cardGb} GB.`
+ }
+ return null
+}
+
+/** The way out after the line, a button when LU Cloud can be used. */
+export const THREE_D_USE_CLOUD = 'Use a LU Cloud 3D model instead.'