Forge is an Aucctus-focused Idea -> 3D Prototype demo. It turns a product brief and supporting context into brand DNA, a product spec, a generated render, hosted 3D assets, an interactive prototype studio, and a stakeholder launch package.

The 3D path now uses hosted APIs. There is no local model worker, Lambda instance, SSH tunnel, or project-owned GPU setup required for the demo.

React Frontend
  -> Flask API Orchestrator
      -> SQLite project store
      -> Backboard/LLM adapter
      -> OpenAI image generation
      -> Cloudinary asset storage
      -> Fal hosted 3D APIs
          -> SAM 3D Objects
          -> TRELLIS.2
      -> Composio and Pingram launch actions
      -> Polarity and CyStack evidence panels

Copy the template:

cp .env.example .env

Hosted 3D defaults:

THREED_PROVIDER=fal
THREED_JOB_TYPE=sam3d
THREED_TIMEOUT_SECONDS=900
FAL_KEY=

Use THREED_JOB_TYPE=trellis2 to switch the 3D provider call to TRELLIS.2.

Live image defaults:

ENABLE_LIVE_IMAGE_API=true
IMAGE_PROVIDER=openai
OPENAI_IMAGE_MODEL=gpt-image-2
IMAGE_API_KEY=

Cloudinary is optional but recommended for the demo:

ENABLE_CLOUDINARY=true
CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=

Never commit .env.

Backend:

cd backend
python -m forge_api.app

Frontend:

cd frontend
npm run dev

One-command local stack:

npm run dev:stack

npm --prefix frontend test
pytest backend/tests
ruff check backend scripts
npm --prefix frontend run lint
npm --prefix frontend run build

• Default 3D provider is Fal SAM 3D Objects because it returns object reconstruction outputs without local GPU setup.
• TRELLIS.2 is available by changing THREED_JOB_TYPE.
• If a hosted provider fails or a key is missing, Forge falls back to the deterministic prototype so the UI remains usable.
• Sponsor APIs stay behind backend adapters; no provider keys are exposed to the frontend.