Skip to main content

Yummy Optimizer for Gorgeous Assets

Project description

Build Status PYPI Version License Gitter

YOGA is a command-line tool and a library that can:

  • convert and optimize images from various format to JPEG and PNG,
  • convert and optimize 3D models from various formats to GLB.

Images are opened using Pillow and optimized using Guetzli (for JPEGs) and Zopflipng (for PNGs).

3D Models are converted and optimized using assimp. If models contain or reference images, they are processed by YOGA’s image optimizer.

Convert and optimize an image from CLI:

yoga  image  input.png  output.png
yoga  image  --output-format=jpeg  --jpeg-quality=84  input.png  output.jpg
yoga  image  --help

Convert and optimize a 3D model from CLI:

yoga  model  input.fbx  output.glb
yoga  model  --no-graph-optimization  --no-meshes-optimization  --image-output-format=jpeg  --image-jpeg-quality=84  input.fbx  output.glb
yoga  model  --help


From PYPI (Linux / Mac OS?)

Run the following command (as root on Linux):

pip install yoga

From this repository (Linux / Mac OS?)

Clone the repository:

git clone

Go to the project’s directory:

cd yoga

Build and install using the following command:

python install


Building YOGA on Windows is not supported yet…

Installing Development Dependencies

pip install .[dev]


  • 0.10.2:
    • Updates assimp and python libraries
  • 0.10.1:
    • Fixes an issue that occures when output file does not already exist
  • 0.10.0:
    • Prevent overwriting of the output file when an error occurs (#17)
    • Unicode path support (#16)
  • 0.10.0b1:
    • Verbose and quiet modes,
    • Allows to pass textures from memory instead of looking on the filesystem,
    • Allows to pass a fallback texture instead of raising an error.
  • 0.9.1b1:
    • Automatic selection of the output format (png or jpeg),
    • Prevent duplication of textures that are shared between materials,
    • Fixes Windows paths of textures.
  • 0.9.0b1: First release (only GLB output for models, no image auto output format)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for yoga, version 0.10.2
Filename, size File type Python version Upload date Hashes
Filename, size yoga-0.10.2.tar.gz (2.5 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page