Installation¶

Standalone app (recommended)¶

Pre-built desktop installers for Windows, macOS, and Linux are available at forgegen.app. No Python, no FFmpeg install, no dependencies — unzip and run.

Download for Windows Download for macOS Download for Linux

The rest of this page covers installing from source — for developers, contributors, or users who want to run the CLI / Python library directly.

From source¶

Requirements¶

Python 3.10 or newer
FFmpeg (required for video files; not needed for audio-only use)

Python dependencies¶

git clone https://github.com/liquid-releasing/forgegen.git
git clone https://github.com/liquid-releasing/videoflow.git

cd forgegen
pip install -r requirements.txt

FFmpeg¶

FFmpeg is required to extract audio from video files (MP4, MKV, MOV, AVI, etc.). If you only work with audio files (MP3, WAV, FLAC, etc.) you can skip this.

Windows¶

Install the essentials build via winget:

winget install Gyan.FFmpeg.Essentials

Then restart your terminal (and Streamlit if it is already running) so the updated PATH takes effect.

To verify:

ffmpeg -version

Manual install

If winget is not available, download the essentials build from ffmpeg.org/download.html → Windows builds by Gyan. Extract the zip, copy the bin/ folder contents somewhere on your PATH (e.g. C:\ffmpeg\bin), and add that folder to your system PATH in Environment Variables.

macOS¶

Install via Homebrew:

brew install ffmpeg

To verify:

ffmpeg -version

No Homebrew?

Install Homebrew first: brew.sh Or use MacPorts: sudo port install ffmpeg

Linux¶

Ubuntu / Debian:

sudo apt update && sudo apt install ffmpeg

Fedora / RHEL:

sudo dnf install ffmpeg

Arch:

sudo pacman -S ffmpeg

To verify:

ffmpeg -version

Launching the UI¶

cd forgegen
streamlit run app.py

Open http://localhost:8501 in your browser.

CLI only (no UI)¶

If you only need the CLI and don't want to install Streamlit:

pip install -e ../videoflow[audio]
videoflow generate-funscript track.mp3