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.
TypeScript agentai-chatai-studioall-in-onecoding-agentdesktop-appfluximage-generationlinuxllmlocal-ailocal-llmopen-sourceprivacyself-hostedstable-diffusionuncensoreduncensored-aivideo-generationwindows
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.tsnew file mode 100644index 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.tsxindex 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 linethat LU Cloud runs it, closable for the session. */}diff --git a/src/components/create/experimental/ThreeDHardwareNotice.tsx b/src/components/create/experimental/ThreeDHardwareNotice.tsxnew file mode 100644index 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.tsxindex 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.tsxnew file mode 100644index 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.tsnew file mode 100644index 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.'