Skip to main content

No project description provided

Project description

PyPoi is an image processing GUI program written in Python under Apache License 2.0. PyPoi stands for “Python Program for Poisson Image Editing”.

It enables you to try the Poisson Image Editing method interactively. Some examples are already ready for you, but you can also load arbitrary images and try it.

demo gif

demo gif

Get Started

You can install PyPoi through pip. Alternatively binary files are available for Windows or Mac OS, you simply need to download files and run it to try this program.

Use pip

pip install pypoi

Once you install PyPoi, you can run pypoi command to open the GUI.

Simple installation

For non-developer or Windows user. 1. Go to the release page 2. From the latest version, download zip file (recommended) or executable file. 3. If you download zip file, extract the file in any folder, and double click

Run from repository (for developer)

You need to have Python2.7 and pip installed before starting it. It is recommended to use virtualenv. Please refer to this guide to know how to install/use it if you’re not familiar with it.

First of all, clone the repository

git clone
cd PyPoi

Then create a new virtualenv

mkvirtualenv pypoi

Install required packages

pip install -r requirements.txt

If you get error in pyamg installation, please install numpy first by the following command, and try the install command above again.

pip install $(grep numpy requirements.txt)
# or
# pip install numpy==1.8.1
# or
# pip install numpy

Alright, now you’re ready to start. Try the following command. An old-fashioned tkinter GUI should appear in front of you :beer:.

cd pypoi

What is Poisson Image Editing?

Poisson Image Editing is a technique to blend two images seamlessly.

This method is firstly introduced by Patrick Pérez and others in ACM SIGGRAPH 2003. The original theses is available here (pdf).


There are many resources about Poisson Image Editing and I’ll leave explanations to them.

Implementation in other languages

There have already been several implementation in other language. * **Java** by Chris Tralie * **Python** by parosky * As of v0.1.0, core calculation is the copy of this implementation. * **JavaScript** by takuti * Introduction in Japanese is available too * **MATLAB and C** by Toshihiko Yamasaki (pdf)

Found issues?

Please raise an issue from github issue page.

What’s next?

I know there are a lot of space to improve. Main enhancements are listed in the issue tracker, for example, * #8 Gradient mixture support * #3 Add tests * #12 Calculation speed improvement

It’s more than welcome if you can pick up one/some of them.


PyPoi is provided under Apache License 2.0. Please refer to LICENSE


The core function is from parosky/poissonblending/

Project details

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pypoi-0.2.1-py2-none-any.whl (2.2 MB) Copy SHA256 hash SHA256 Wheel 2.7 Nov 3, 2015
pypoi-0.2.1.tar.gz (2.2 MB) Copy SHA256 hash SHA256 Source None Nov 3, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page