README.md

pilgram

A python library for instagram filters.

The filter implementations are inspired by CSSgram.

Requirements

• Python >= 3.4
• Pillow or pillow-simd
• NumPy

Install

pip install pillow>=4.1.0 # or pip install pillow-simd
pip install numpy
pip install pilgram

Usage

Available instagram filters on pilgram:

• _1977
• aden
• brannan
• brooklyn
• clarendon
• earlybird
• gingham
• hudson
• inkwell
• kelvin
• lark
• lofi
• maven
• mayfair
• moon
• nashville
• perpetua
• reyes
• rise
• slumber
• stinson
• toaster
• valencia
• walden
• willow
• xpro2

from PIL import Image
import pilgram

im = Image.open('sample.jpg')
pilgram.aden(im).save('sample-aden.jpg')

Similarly, pilgram provides css filters and blend modes as a by-product.

Available css filters on pilgram.css:

• contrast
• grayscale
• hue_rotate
• saturate
• sepia

from PIL import Image
import pilgram.css

im = Image.open('sample.jpg')
pilgram.css.sepia(im).save('sample-sepia.jpg')

Available blend modes on pilgram.css.blending:

• color
• color_burn
• color_dodge
• darken
• difference
• exclusion
• hard_light
• hue
• lighten
• multiply
• normal
• overlay
• screen
• soft_light

from PIL import Image
import pilgram.css.blending

backdrop = Image.open('backdrop.jpg')
source = Image.open('source.jpg')
pilgram.css.blending.color(backdrop, source).save('blending.jpg')

Demo

• notebooks/example.ipynb

Filter performance comparison with instagram-filters

• notebooks/filter-performance-comparison.ipynb

Test

pipenv install --dev
make test     # pytest
make test-tox # pytest with tox