Installation

Requirements

Python 3.7 or higher
FFmpeg installed and accessible in your system’s PATH

Installing Python

Windows:

Visit python.org
Click “Download Python 3.x.x” (latest version for Windows)
Run the installer executable
Important: Check the box “Add Python to PATH” during installation
Click “Install Now” or customize installation options as needed
Verify installation by opening Command Prompt and running:

python --version
pip --version

Installing FFmpeg

macOS (using Homebrew):

brew install ffmpeg

Ubuntu/Debian:

sudo apt update
sudo apt install ffmpeg

Windows:

Download FFmpeg from https://ffmpeg.org/download.html
Extract the files and add the bin directory to your system PATH
Verify installation by running ffmpeg -version in Command Prompt

Installing Dialogue Guardian

From PyPI (Recommended)

pip install dialogue-guardian

From Source

git clone https://github.com/tsnearly/dialogue-guardian.git
cd dialogue-guardian
pip install -e .

Development Installation

For development work:

git clone https://github.com/tsnearly/dialogue-guardian.git
cd dialogue-guardian
pip install -e .
pip install -r dev-requirements.txt

Verification

Verify the installation by running:

guardian --version

You should see the version number displayed.