Skip to main content

library for instagram filters

Project description


PyPI PyPI - Python Version Python CI codecov

A python library for instagram filters.


The filter implementations are inspired by CSSgram.



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


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 ='sample.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 ='sample.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 ='backdrop.jpg')
source ='source.jpg')
pilgram.css.blending.color(backdrop, source).save('blending.jpg')


Open In Colab

Filter performance comparison with instagram-filters

Open In Colab

filter performance comparison


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

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 pilgram, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pilgram-1.2.0-py3-none-any.whl (804.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pilgram-1.2.0.tar.gz (766.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page