akiomik/pilgram

A python library for instagram filters

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

pilgram's Issues

aden result half filtered

no error occured but the result is not expected (half filtered)

detail
as you can see in picture above
the filtered apply from the center to right,
while left side is not filter applied

expected result
filtered is applied to whole image

best regards

ImportError: cannot import name 'css'

I am facing the following error when trying to run your sample. Any ideas what is wrong here?
Using it on Ubuntu with python3.

Traceback (most recent call last):
  File "filter.py", line 2, in <module>
    import pilgram
  File "/usr/local/lib/python3.4/dist-packages/pilgram/__init__.py", line 16, in <module>
    from pilgram._1977 import _1977
  File "/usr/local/lib/python3.4/dist-packages/pilgram/_1977.py", line 17, in <module>
    from pilgram import css
  File "/usr/local/lib/python3.4/dist-packages/pilgram/css/__init__.py", line 22, in <module>
    from pilgram.css import blending  # noqa
  File "/usr/local/lib/python3.4/dist-packages/pilgram/css/blending/__init__.py", line 21, in <module>
    from pilgram.css.blending.overlay import overlay
  File "/usr/local/lib/python3.4/dist-packages/pilgram/css/blending/overlay.py", line 15, in <module>
    from pilgram import css
ImportError: cannot import name 'css'

DeprecationWarning: an integer is required (got type float)

pilgram/css/blending/tests/test_soft_light.py: 2304 warnings
pilgram/tests/test_gingham.py: 768 warnings                                             
pilgram/tests/test_moon.py: 768 warnings                                                
pilgram/tests/test_perpetua.py: 768 warnings              
pilgram/tests/test_reyes.py: 768 warnings                                               
pilgram/tests/test_slumber.py: 768 warnings                                                                                                                                      
pilgram/tests/test_stinson.py: 768 warnings                                             
  /Users/akiomi/src/github.com/akiomik/pilgram/.venv/lib/python3.9/site-packages/PIL/Image.py:1600: DeprecationWarning: an integer is required (got type float).  Implicit conve$
sion to integers using __int__ is deprecated, and may be removed in a future version of Python.
    return self._new(self.im.point(lut, mode))

-- Docs: https://docs.pytest.org/en/stable/warnings.html