The TailwindCSS of automated video creation for social media.

Description

LeMontage is a local-first YAML pipeline engine for turning long videos into short, captioned clips. You describe the workflow once, then LeMontage runs the media steps locally: transcription, clip detection, cutting, captions and export.

The current engine targets MP4 input and local execution. Pipelines are plain YAML files, so they can be reviewed, versioned, shared and generated by coding agents.

lemontage init pipeline.yaml
lemontage validate pipeline.yaml
lemontage run pipeline.yaml

Tech Stack

• Language: Python 3.10+
• Pipeline format: YAML
• CLI packaging: setuptools, editable installs, pipx
• Media processing: FFmpeg via imageio-ffmpeg
• Speech-to-text: Whisper through faster-whisper
• Validation: custom YAML validator backed by pyyaml
• Testing: pytest
• Linting and formatting: Ruff, pre-commit
• Containers: Docker, Docker Compose
• CI and security: GitHub Actions, Hadolint, Trivy, CodeQL

Install

Method	Best for	Security note
pipx from GitHub	Daily CLI usage	Isolated Python app install. Pin a reviewed tag or commit for stricter environments.
`curl	bash`	Fast local install
Docker Compose	Local isolated runs	Recommended when you want container isolation with simple commands.
Docker CLI	CI or server builds	Good for reproducible image builds. Pin the source ref.
Source install	Development	Most auditable path because you inspect the repo before running it.

Full install and deployment details are in docs/INSTALL.md.

Quick install:

curl -fsSL https://raw.githubusercontent.com/FleoThing/LeMontage/main/infrastructure/script/get.sh | bash

Docker Compose:

git clone https://github.com/FleoThing/LeMontage
cd LeMontage
docker compose -f infrastructure/local/compose.yaml build
docker compose -f infrastructure/local/compose.yaml run --rm lemontage run pipeline.yaml

Source setup:

git clone https://github.com/FleoThing/LeMontage
cd LeMontage
python -m venv .venv
. .venv/bin/activate
python -m pip install -U pip
pip install -e ".[engine,dev]"

Documentation

• YAML specification
• Architecture
• Install and deployment
• Release process
• Roadmap
• Contributing
• Support
• Security policy
• Changelog