>>> from imagesoup import ImageSoup
>>>
>>> soup = ImageSoup()
>>> images = soup.search('"Arya Stark"', n_images=10)
>>>
>>> arya = images[0]
>>> arya.URL
'https://upload.wikimedia.org/wikipedia/en/3/39/Arya_Stark-Maisie_Williams.jpg'
>>> arya.show()
>>> arya.size
(300, 404)
>>> arya.dpi
(72, 72)
>>> arya.color_count
7269
>>> arya.main_color(n=2)
[('black', 0.6219224422442244), ('darkslategrey', 0.27796204620462045)]
>>> arya.to_file('arya.jpg')To install ImageSoup, simply use pip:
$ pip install imagesoup