How to show PIL Image in ipython notebook


This is my code

from PIL import Image
pil_im ='data/empire.jpg')

I would like to do some image manipulation on it, and then show it on screen.
I am having problem with showing PIL Image in python notebook.

I have tried:

print pil_im

And just


But both just give me:

<PIL.JpegImagePlugin.JpegImageFile image mode=RGB size=569x800 at 0x10ECA0710>
Asked By: WebOrCode



Updated 2021/11/17

When using PIL/Pillow, Jupyter Notebooks now have a display built-in that will show the image directly, with no extra fuss.


Jupyter will also show the image if it is simply the last line in a cell (this has changed since the original post). Thanks to answers from @Dean and @Prabhat for pointing this out.

Other Methods

From File

You can also use IPython’s display module to load the image. You can read more from the doc.

from IPython.display import Image 
pil_img = Image(filename='data/empire.jpg')

From PIL.Image Object

As OP’s requirement is to use PIL, if you want to show inline image, you can use matplotlib.pyplot.imshow with numpy.asarray like this too:

from matplotlib.pyplot import imshow
import numpy as np
from PIL import Image

%matplotlib inline
pil_im ='data/empire.jpg', 'r')

If you only require a preview rather than an inline, you may just use show like this:

pil_im ='data/empire.jpg', 'r')
Answered By: Anzel

If you are using the pylab extension, you could convert the image to a numpy array and use matplotlib’s imshow.

%pylab # only if not started with the --pylab option

As mentioned in the comments, the pylab module is deprecated, so use the matplotlib magic instead and import the function explicitly:

from matplotlib.pyplot import imshow 
Answered By: Rob

I found that this is working

# source:
from io import BytesIO

from IPython import display
from PIL import Image

def display_pil_image(im):
   """Displayhook function for PIL Images, rendered as PNG."""

   b = BytesIO(), format='png')
   data = b.getvalue()

   ip_img = display.Image(data=data, format='png', embed=True)
   return ip_img._repr_png_()

# register display func with PNG formatter:
png_formatter = get_ipython().display_formatter.formatters['image/png']
dpi = png_formatter.for_type(Image.Image, display_pil_image)

After this I can just do:


But this must be last line in cell, with no print after it

Answered By: WebOrCode

case python3

from PIL import Image
from IPython.display import HTML
from io import BytesIO
from base64 import b64encode

pil_im ='data/empire.jpg')
b = BytesIO(), format='png')
HTML("<img src='data:image/png;base64,{0}'/>".format(b64encode(b.getvalue()).decode('utf-8')))
Answered By: gaziya

Based on other answers and my tries, best experience would be first installing, pillow and scipy, then using the following starting code on your jupyter notebook:

%matplotlib inline
from matplotlib.pyplot import imshow
from scipy.misc import imread

imshow(imread('image.jpg', 1))
Answered By: Ebrahim Byagowi

Use IPython display to render PIL images in a notebook.

from PIL import Image               # to load images
from IPython.display import display # to display images

pil_im ='path/to/image.jpg')
Answered By: sathyz

You can open an image using the Image class from the package PIL and display it with plt.imshow directly.

# First import libraries.
from PIL import Image
import matplotlib.pyplot as plt

# The folliwing line is useful in Jupyter notebook
%matplotlib inline

# Open your file image using the path
img =<path_to_image>)

# Since plt knows how to handle instance of the Image class, just input your loaded image to imshow method
Answered By: M . Franklin

A cleaner Python3 version that use standard numpy, matplotlib and PIL. Merging the answer for opening from URL.

import matplotlib.pyplot as plt
from PIL import Image
import numpy as np

pil_im ='image.jpg')
## Uncomment to open from URL
#import requests
#r = requests.get('')
#pil_im =
im_array = np.asarray(pil_im)
Answered By: Punnerud

much simpler in jupyter using pillow.

from PIL import Image'image.png')
Answered By: Prabhat

I suggest following installation by no image show
(from PIL import Image)

$ sudo apt-get install imagemagick

Answered By: Dr.-Ing. Hiesik KIm

Just use

from IPython.display import Image 
Answered By: Quanlong

In order to simply visualize the image in a notebook you can use display()

%matplotlib inline
from PIL import Image

im =
Answered By: Dean