██████╗ ██████╗ ██████╗      ██████╗ ██████╗ ███████╗ █████╗ ████████╗ ██████╗ ██████╗ 
██╔══██╗██╔══██╗██╔══██╗    ██╔════╝ ██╔══██╗██╔════╝██╔══██╗╚══██╔══╝██╔═══██╗██╔══██╗
██████╔╝██║  ██║██████╔╝    ██║      ██████╔╝█████╗  ███████║   ██║   ██║   ██║██████╔╝
██╔══██╗██║  ██║██╔══██╗    ██║      ██╔══██╗██╔══╝  ██╔══██║   ██║   ██║   ██║██╔══██╗
██████╔╝██████╔╝██████╔╝    ╚██████╗ ██║  ██║███████╗██║  ██║   ██║   ╚██████╔╝██║  ██║
╚═════╝ ╚═════╝ ╚═════╝      ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝
                                 
                             E X T E N S I O N   S U I T E

🎨 BDB Creator Extension

Agentic 3D Generation, Show Control & Automated Video Production Suite

🌐 Language / Sprache / Idioma: English

The BDB Creator Extension is a standalone, heavy-lifting suite of specialized creation engines and MCP servers for AI agents. To keep the core bdb-dev-optimized-agent-skills lightweight, all generative visual pipelines have been decoupled into this powerful extension.

📚 Documentation Wiki

Comprehensive developer manuals and design specifications are maintained in the project's OpenWiki directory:

• 📐 System Architecture: 3D generation, video automation, and ComfyUI MCP pipeline structure.
• 📋 Development Conventions: Python environment rules, node runtime standards, and MCP contracts.
• 📜 Changelog: Version highlights and release history.

🏗️ Ecosystem Topology

The Creator Extension acts as the creative bridge between your AI Orchestrator (e.g., BDB OS Agent Workspace) and complex media generation software.

graph TD
    Agent[🤖 BDB OS Agent Workspace] -->|MCP / API| Core[🎨 BDB Creator Extension]
    
    subgraph Heavy Pipelines
    Core --> E3D[🧊 3D Engine]
    Core --> EVideo[🎬 Video Engine]
    Core --> EComfy[🧠 ComfyUI Server]
    end
    
    subgraph 3D Generation
    E3D -->|TripoSR & TRELLIS| Mesh[OBJ / GLB Generation]
    E3D -->|Text-to-CAD| CAD[Parametric STEP / STL]
    end
    
    subgraph Video Production
    EVideo -->|OpenMontage| PreProd[Script & Asset Assembly]
    EVideo -->|Shotcraft| Motion[Remotion Motion Design]
    EVideo -->|Palmier Pro| NLE[NLE Timeline via HTTP]
    end
    
    subgraph Generative Renders
    EComfy -->|FLUX / SDXL| ImageGen[High-Res Imagery]
    EComfy -->|AnimateDiff| VideoGen[Video Rendering]
    end

⚙️ Core Engines & Features

🧊 1. BDB 3D Engine (engines/3d/)

Generates 3D models and parametric CAD assets directly from images or text prompts:

• Pipeline A (Organic Object): Image → TripoSR → .obj/.glb mesh (<0.5s inference).
• Pipeline B (Parametric CAD): Image → TRELLIS → CAD-Recode → CadQuery Python Script → .step solid.
• Pipeline C (Hardware Part): Text Prompt → text-to-cad → STEP/STL/URDF assembly.

🎬 2. BDB Video Engine (engines/video/)

Fully automated video production pipeline from initial prompt to finished NLE timeline, heavily powered by our OpenMontage integration:

• Agentic Video Production: Describe what you want in plain language — your agent handles research, scripting, asset generation, editing, and final composition.
• Reference Video Extraction: Start from a YouTube, TikTok, or local clip to extract pacing, keyframes, and structure as a baseline for the AI.
• The Backlot Living Storyboard: A visual dashboard that fills itself in as the pipeline runs. The storyboard acts as a real approval gate—review scenes, takes, and costs visually before the final render.
• Shot Crafting (video-shotcraft): Asset injection into Remotion motion design templates.
• Assembly (Palmier Pro MCP): Programmatic import into Palmier Pro timeline via HTTP MCP (http://127.0.0.1:19789/mcp).
• Refinement (Human-in-the-Loop): Live timeline editing via natural language chat commands.

Production Pipelines Each pipeline is a complete production workflow, from idea to finished video:

• Cinematic Pipeline: High-fidelity AI video generation (Kling/Runway/Wan2.1) + Voiceover.
• Stock Documentary: Automated retrieval of free stock footage (Pexels/Pixabay) + Ken Burns effects.
• Animation/Anime Pipeline: Image-to-Video generation using stylized models (Niji/FLUX) + Parallax motion.

🧠 3. BDB ComfyUI Engine & Supported Providers

The Creator Extension uses a unified provider layer that blends local compute via ComfyUI MCP with top-tier cloud APIs:

1. Local ComfyUI MCP (http://127.0.0.1:8188)

• Local Stable Diffusion & FLUX workflow execution exposed as an MCP server.
• Zero-cost automated image (FLUX/SDXL) and video (Wan2.1/AnimateDiff) rendering for AI agents.

2. Cloud Providers (via OpenMontage)

• Video Generation: 15 providers (Kling, Runway, Luma, Veo, etc.)
• Image Generation: 11 tools/providers (Midjourney via API, OpenAI, Fal.ai)
• Text-to-Speech: 5 providers (ElevenLabs, OpenAI, Google)
• Music & Sound: Suno API and Royalty-Free libraries

📂 Repository Architecture

bdb-dev-creator-extension/
├── engines/
│   ├── 3d/
│   │   ├── README.md               # 3D Engine documentation & pipeline specs
│   │   ├── trellis/                # Microsoft TRELLIS (High-fidelity Image-to-3D)
│   │   ├── triposr/                # Stability AI TripoSR (Ultra-fast Image-to-Mesh)
│   │   └── text-to-cad/            # Parametric CAD (STEP, STL, URDF, CadQuery)
│   │
│   └── video/
│       ├── README.md               # Video Engine documentation & pipeline specs
│       ├── openmontage/            # AI Orchestrator (scripting, assets, storyboarding)
│       ├── video-shotcraft/        # 100+ Remotion cinema-grade motion templates
│       └── palmier-pro/            # macOS NLE with HTTP MCP Server interface
│
└── mcps/
    └── comfyui-mcp/
        ├── README.md               # ComfyUI MCP specification & endpoints
        └── ComfyUI/                # Local ComfyUI core engine

🚀 Installation & Integration

As a BDB Agent OS Plugin (Recommended)

Integrate directly via the bdb-dev-optimized-agent-skills interactive installer. Simply select the Creator Extension add-on during the terminal setup.

As a Standalone Package

Clone or install into your workspace manually if you want to use the engines outside of the BDB OS environment:

git clone https://github.com/hybridlabor-api/bdb-dev-creator-extension.git

📄 License

This repository contains whitelabeled forks of open-source projects adapted for the BDB Agent OS ecosystem. See individual component directories for specific licenses (Apache 2.0, MIT, GPLv3).