● Install

Set up your local video pipeline.

Inchframe is local-first. Install the app, prove ComfyUI/LTX works locally, add your own AI provider keys, then run a small Inchframe test before serious renders.

Install checklist.

Designed for a clean Windows/local first install with no saved API keys, no machine-specific paths, and no generated project runs bundled.

1. Extract Inchframe

Extract the ZIP to a permanent local folder such as D:\Inchframe. Avoid running it from Downloads or a temporary folder.

2. Install Python requirements

Install Python and the required packages listed with the release. Advanced users can run the compile check before first launch.

3. Install ComfyUI

Install ComfyUI from the official Comfy download site. Advanced/manual users can use the official ComfyUI GitHub repository.

4. Confirm ComfyUI opens

Start ComfyUI once and confirm it opens locally, normally at http://127.0.0.1:8188.

5. Add LTX / IAV support

In ComfyUI, open Templates / Template Library, search for LTX or LTX-2.3, choose an Image-to-Video template, then Download all required models/assets.

6. Test inside ComfyUI first

Run a short Image-to-Video / IAV test directly inside ComfyUI before connecting Inchframe.

7. Configure local paths

Edit config.json with comfy_input_dir, comfy_output_dir, and optional ComfyUI start command / working directory settings.

8. Add AI provider keys

Add OpenAI and/or Google Gemini keys in Settings > API Management, or set environment variables before starting Inchframe.

9. Start Inchframe

Launch with run_inchframe.bat or python storyboard_web.py --config config.json, then open http://127.0.0.1:8787.

10. Run System Check

Use Settings > System Check to confirm FFmpeg, ComfyUI, local paths, and API keys before a real project.

11. Make a small test project

Do not start with a long render. Confirm a small Inchframe project renders successfully first.

Bring your own AI keys.

Inchframe does not ship with API keys. Your keys stay under your own provider accounts and can be added in the app or through Windows environment variables.

OpenAI key

Create an OpenAI Platform key, then add it in Inchframe Settings > API Management or set OPENAI_API_KEY as a Windows environment variable.

setx OPENAI_API_KEY "your_openai_key_here"

Google Gemini key

Create a Gemini API key in Google AI Studio. Gemini keys are tied to a Google Cloud project. Add it in Inchframe or set GEMINI_API_KEY / GOOGLE_API_KEY.

setx GEMINI_API_KEY "your_gemini_key_here"

Key safety

Do not paste real API keys into screenshots, public repos, chat, support tickets, email, Discord, or Slack. If a key is exposed, revoke it in the provider dashboard and create a new one.