Skip to content
modelBridge Docs

Installation

System Requirements

Section titled “System Requirements”
  • macOS 12 (Monterey) or later
  • Adobe Premiere Pro 23.x or later (2023 release or newer)
  • Node.js 18 or later (required for the local backend server)
  • ~50 MB of disk space
  • Internet connection (required for fal.ai API communication)

Step 1: Download modelBridge.ai

Section titled “Step 1: Download modelBridge.ai”

Download the latest version of modelBridge.ai from modelbridge.app. You will receive a .zip archive containing the extension folder.

Step 2: Install the Extension

Section titled “Step 2: Install the Extension”

Unzip the archive and copy the com.fittoframe folder to the CEP extensions directory:

~/Library/Application Support/Adobe/CEP/extensions/

Your final path should look like:

~/Library/Application Support/Adobe/CEP/extensions/com.fittoframe/

Step 3: Enable Unsigned Extensions

Section titled “Step 3: Enable Unsigned Extensions”

Adobe CEP requires unsigned extensions to be explicitly allowed. Open Terminal and run:

Terminal window
defaults write ~/Library/Preferences/com.adobe.CSXS.11.plist PlayerDebugMode 1

This tells Premiere Pro to load extensions that are not signed through the Adobe Exchange. You only need to run this once.

Step 4: Install Backend Dependencies

Section titled “Step 4: Install Backend Dependencies”

modelBridge.ai runs a local Node.js server for media processing and API communication. Install its dependencies:

Terminal window
cd ~/Library/Application\ Support/Adobe/CEP/extensions/com.fittoframe/node
npm install

Step 5: Restart Premiere Pro

Section titled “Step 5: Restart Premiere Pro”

Close and reopen Adobe Premiere Pro. The extension needs a fresh launch to be detected.

Step 6: Open the Panel

Section titled “Step 6: Open the Panel”

In Premiere Pro, go to:

Window > Extensions > modelBridge.ai

The panel will open and automatically start the local backend server on port 3000.

Verify Installation

Section titled “Verify Installation”

If the panel loads and you see the modelBridge.ai interface with tabs (Generate, Models, Billing, Settings), the installation was successful.

If the panel does not appear:

  1. Confirm the extension folder is in the correct location
  2. Verify the PlayerDebugMode command was run successfully
  3. Check that Node.js is installed (node --version in Terminal)
  4. Restart Premiere Pro one more time

Next Steps

Section titled “Next Steps”

Head to API Key Setup to connect your fal.ai account.