pierogis is a framework for image and animation processing. Ingredients that describe image processing functions can be assembled
into recipes and used to cook an image or animation.
pip install pierogis pierogis custom teton.png "resize --width 768 --height 768; sort; quantize; resize --scale 4" -o output.png # or pierogis custom teton.png recipe.txt -o output.png
resize --width 768 --height 768; sort; quantize -c 000000 ffffff 668a61 cbb8a2 b6d655 434d1f 5fb7d2 6d8ab9 3876c1 515b5e a8725f d7b6aa 3c2329 f78693 637186 00407A; resize -s 4;
install from a wheel with pip
pip install pierogis
PIL. PIL requires some external C libraries for handling image files. You probably don't have
to worry about this. If you do, try a
To build from source (either the repository or the sdist), you will need to install the rust stable toolchain.
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh pip install -r requirements.txt pip install .
Note that the python package was previously called
That was supposed to denote the difference between the package
and the Rust algorithms (
pierogis_rs) that it relied on.
These two parts were combined into one namespace in the
and the split naming became redundant.
pip install pyrogis==0.4.0 will install
richcli to cook à la carte recipes, or provide a recipe in a document (see docs)
Rustfor more speed.
The original python pixelsort package inspired this package. While the
underlying algorithm of that package and of
sort in this one is
supposed to be functionally the same, details of the implementation may differ.
When you encounter an error, there are some guidelines that will make it easier to help you:
pip uninstall pierogisthen
pip install pierogis --no-cache-dirto reinstall.
pierogisthat you are using in issues to rule that out.
pip list-> pierogis _._._
pillow, install the rust toolchain, and start praying. There will be a website with a visual editor for this software so stay tuned.
Hopefully all levels of skills can use this package. Any form of contributing is appreciated; passive-aggressive semi-anonymous thumbs down is not appreciated.
Everyone using and contributing to this package is doing it for the love of the game.
Don't feel like your issue is too small to make an issue. Pull requests are always welcome and anyone interested in dev work should join the discord.
Ingredient type algorithm/function suggestions can go in the ingredients channel. You can post your creations in the
demo channel as well.
This library is licensed under the AGPL v3.
Art used for demos is the property of their respective owners.
The following statements are not necessarily legally binding. If they seem to contradict the license, follow the license.
The licenses of packages used by this software vary, but are understood to be compatible with AGPL. If you take issue with this package's use of other software regardless of legal concern, please reach out, and it can be removed from this package.
Also understand that there may be implications from those licenses on your use of this package.
Review the AGPL yourself if you intend to use this package in any software, but know that it was chosen to encourage that all related works be open source.
The use of AGPL does not mean that this cannot be monetized, but it does generally mean that you will need to share source code of improvements on this package; at least modules related to this package.
If your paid derivative work adds marginal value to what is included in this package, the author reserves the right to go to great lengths to make a free (and better) alternative to your derivative work.