Installation

Requirements

Before installing the Mosaico framework, you need to make sure you have the following prerequisites:

1. Python 3.10 or superior

   Mosaico requires Python 3.10 or superior. You can check your Python version by running:

   python --version
   

   If you need to update or install Python, visit python.org to get the latest version.

2. FFmpeg

   Mosaico depends on FFmpeg for video processing. You must have FFmpeg installed and available in your system PATH.

   To check if FFmpeg is installed, run:

   ffmpeg -version
   

   If it's not installed, you can get it from ffmpeg.org or use your operating system's package manager.

   Ubuntu/DebianmacOS (with Homebrew)Windows (with Chocolatey)

   sudo apt update
   sudo apt install ffmpeg
   

   brew install ffmpeg
   

   choco install ffmpeg
   

After ensuring these prerequisites are satisfied, you can proceed with the Mosaico installation.

Installation

To install Mosaico, run the following command according to your preferred package manager:

pippipxuvpoetrypdm

pip install mosaico

pipx install mosaico

uv add mosaico

poetry add mosaico

pdm add mosaico

It is also possible to install Mosaico from source by cloning the repository and running the following command:

git clone https://github.com/folhalab/mosaico.git
cd mosaico
pip install -e .