Madurify

A Python application with CLI and web interfaces that lets you swap faces in images without using AI!

Features

• Face detection using dlib
• Accurate face region masking with full jaw contour coverage
• Multi-source face template selection for best match
• Color correction in LAB color space
• Poisson and multi-band blending
• Glasses and mouth interior restoration
• Video and real-time webcam face swapping with temporal smoothing
• Web interface with drag-and-drop upload

Requirements

• Python 3.11+

Installation

1. Clone the repository:

git clone https://github.com/iakzs/madurify.git
cd madurify

2. Install dependencies, setup the application:

Quick install & setup (if CMake is installed):

pip install -r requirements.txt && pip install -e .

Usage

CLI

Process a single image:

madurify input.jpg -o output.jpg

Or use Python directly:

python -m src.cli.main input.jpg -o output.jpg

Options:

• -o, --output: Output file path (default: input_madurified.jpg)
• -m, --maduro-face: Path to face templates (can be more than one) (default: assets/maduro_face*.jpg)
• -p, --predictor: Path to dlib predictor (default: models/shape_predictor_68_face_landmarks.dat)
• -d, --debug: Save intermediate processing images
• --suffix: Output filename suffix in batch mode (default: _madurified)
• --format: Output format for batch mode (jpg or png)

Video

Process a video file:

madurify input.mp4 -o output.mp4

Webcam

Real-time webcam face swap:

madurify --cam

Controls: q/ESC quit, s snapshot, f toggle mirror.

Web Interface

Start the web server:

uvicorn src.web.app:app --reload

Then open your browser to http://localhost:8000

Warning

The developer and contributors do not contribute to this application for hate purposes. This repository is intended for educational purposes only.

License

See LICENSE file for details.