pilgram

A python library for instagram filters

https://github.com/akiomik/pilgram

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (8.7%) to scientific vocabulary

Keywords

blend-modes css-filters data-augmentation image-augmentation image-blending image-processing instagram instagram-filters pillow

Keywords from Contributors

mesh sequences interactive hacking network-simulation
Last synced: 6 months ago · JSON representation ·

Repository

A python library for instagram filters

Basic Info
  • Host: GitHub
  • Owner: akiomik
  • License: apache-2.0
  • Language: Jupyter Notebook
  • Default Branch: main
  • Homepage:
  • Size: 3.61 MB
Statistics
  • Stars: 120
  • Watchers: 4
  • Forks: 16
  • Open Issues: 1
  • Releases: 7
Topics
blend-modes css-filters data-augmentation image-augmentation image-blending image-processing instagram instagram-filters pillow
Created about 7 years ago · Last pushed 8 months ago
Metadata Files
Readme Funding License Citation

README.md

pilgram

DOI PyPI PyPI - Python Version Python CI codecov

A python library for instagram filters.

screenshot

The filter implementations are inspired by CSSgram.

Requirements

Install

sh 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

```python 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

```python 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

```python 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

Open In Colab

Filter performance comparison with instagram-filters

Open In Colab

filter performance comparison

Test

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

Owner

  • Name: Akiomi KAMAKURA
  • Login: akiomik
  • Kind: user
  • Location: Japan

Bird lover.

Citation (CITATION.cff)

cff-version: 1.2.0
message: If you use pilgram in your work, please cite it as below
title: pilgram
abstract: This library is a python library for instagram filters
authors:
- family-names: Kamakura
  given-names: Akiomi
  orcid: https://orcid.org/0000-0002-2042-712X
keywords:
- python
- instagram
- instagram filters
- css filters
- image blending
- blend modes
- image processing
- data augmentation
- image augmentation
version: 1.2.1
doi: 10.5281/zenodo.6086991
date-released: 2022-02-15
license: Apache-2.0
repository-artifact: https://pypi.org/project/pilgram/
repository-code: https://github.com/akiomik/pilgram
url: https://github.com/akiomik/pilgram

GitHub Events

Total
  • Watch event: 6
  • Delete event: 3
  • Push event: 3
  • Pull request event: 4
  • Fork event: 2
  • Create event: 3
Last Year
  • Watch event: 6
  • Delete event: 3
  • Push event: 3
  • Pull request event: 4
  • Fork event: 2
  • Create event: 3

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 279
  • Total Committers: 2
  • Avg Commits per committer: 139.5
  • Development Distribution Score (DDS): 0.484
Past Year
  • Commits: 8
  • Committers: 1
  • Avg Commits per committer: 8.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
dependabot[bot] 4****] 144
Akiomi Kamakura a****k@g****m 135

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 2
  • Total pull requests: 142
  • Average time to close issues: N/A
  • Average time to close pull requests: 7 days
  • Total issue authors: 2
  • Total pull request authors: 3
  • Average comments per issue: 4.5
  • Average comments per pull request: 0.99
  • Merged pull requests: 122
  • Bot issues: 0
  • Bot pull requests: 127
Past Year
  • Issues: 0
  • Pull requests: 7
  • Average time to close issues: N/A
  • Average time to close pull requests: 5 days
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.14
  • Merged pull requests: 5
  • Bot issues: 0
  • Bot pull requests: 7
Top Authors
Issue Authors
  • JINHUIZHANG (1)
  • sugizo (1)
Pull Request Authors
  • dependabot[bot] (146)
  • akiomik (12)
  • mgrl (3)
Top Labels
Issue Labels
enhancement (1)
Pull Request Labels
dependencies (146) python (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 202,322 last-month
  • Total docker downloads: 1,174
  • Total dependent packages: 0
  • Total dependent repositories: 9
  • Total versions: 7
  • Total maintainers: 1
pypi.org: pilgram

library for instagram filters

  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 9
  • Downloads: 202,322 Last month
  • Docker Downloads: 1,174
Rankings
Docker downloads count: 1.9%
Downloads: 2.3%
Dependent repos count: 4.9%
Average: 6.0%
Stargazers count: 7.4%
Forks count: 9.3%
Dependent packages count: 10.0%
Maintainers (1)
Last synced: 6 months ago

Dependencies

.github/workflows/ci.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite