jankrepl

pychubby

Python

Automated face warping tool.

Last updated Jun 25, 2026

303

Stars

Forks

Issues

Stars/day

Attention Score

View on GitHub ↗ Open in github.dev

Topics

#cli #computer-vision #dlib-face-detection #dlib-face-recognition #face #face-recognition #facial-detection #facial-features #landmark-detection #machine-learning #morphing #transformation #warping

Language breakdown

Python 100.0%

▸ Files click to expand

README

PyPI - Python Version

PyChubby

Tool for automated face warping

intro

Installation

pip install pychubby

If you get an error FileNotFoundError: [Errno 2] No such file or directory: 'cmake': 'cmake', you need to make sure cmake is installed. If you're on OSX you can install this via Homebrew with:

brew install cmake

For other platforms please consult the Cmake documentation at

Description

For each face in an image define what actions are to be performed on it, pychubby will do the rest.

Documentation

Minimal Example

import matplotlib.pyplot as plt
from pychubby.actions import Chubbify, Multiple, Pipeline, Smile from pychubby.detect import LandmarkFace
img_path = 'path/to/your/image' img = plt.imread(img_path)
lf = LandmarkFace.estimate(img)
aperface = Pipeline([Chubbify(), Smile()]) aall = Multiple(aper_face)
newlf,  = a_all.perform(lf) newlf.plot(showlandmarks=False, show_numbers=False)

CLI

pychubby also comes with a CLI that exposes some of its functionality. You can list the commands with pc --help:

Usage: pc [OPTIONS] COMMAND [ARGS]... Automated face warping tool. Options: --help Show this message and exit.

Commands: list List available actions. perform Take an action.

To perform an action (Smile in the example below) and plot the result on the screen

pc perform Smile INPUTIMGPATH

or if you want to create a new image and save it

pc perform Smile INPUTIMGPATH OUTPUTIMGPATH

Development

git clone https://github.com/jankrepl/pychubby.git
cd pychubby
pip install -e .[dev]

🔗 More in this category