YouTipPillow Install
Before installing Pillow, make sure you have:
* Python 3.7 or higher (latest version recommended)
* pip package manager (usually installed with Python)
* Depending on your platform, you may need some additional system libraries and development tools
### Python Version
Pillow requires Python 3.7 or higher.
You can check the Python version with the following command:
python --version # or python3 --version
### pip Tool
pip is Python's package management tool and usually comes with Python.
Check if pip is available:
pip --version # or pip3 --version
If pip is not installed, refer to the (https://pip.pypa.io/en/stable/installation/) for installation.
* * *
## Install Pillow
### Basic Installation Method
The simplest method is to use pip to install:
pip install pillow
Or explicitly specify for Python 3:
pip3 install pillow
If you are using the Anaconda Python distribution:
conda install -c anaconda pillow
### Install Specific Version
If you need to install a specific version of Pillow:
pip install pillow==9.0.0
### Install in Virtual Environment
It is recommended to install Pillow in a virtual environment to avoid dependency conflicts:
# Create virtual environment
python -m venv pillow_env
# Activate virtual environment
# Windows: pillow_envScriptsactivate
# Install Pillow
pip install Pillow
### Install from Source
For advanced users, you can install from source:
Download the source code:
git clone https://github.com/python-pillow/Pillow.git
cd Pillow
Install dependencies:
pip install -r requirements.txt
Compile and install:
python setup.py install
* * *
## Verify Installation
After installation, you can verify if Pillow was successfully installed in the following ways:
### Method 1: Python Interactive Environment
## Example
import PIL
print(PIL.__version__)
### Method 2: Command Line Check
python3 -c "import PIL; print(PIL.__version__)"
If the installation is successful, the version number of Pillow will be displayed.
* * *
## Troubleshooting
### 1. Installation Failed
Possible causes:
* Missing dependency libraries (such as zlib, libjpeg, etc.)
* Permission issues
Solutions:
Linux/macOS users may need to install system dependencies first:
## Example
# Ubuntu/Debian
sudo apt-get install python3-dev python3-setuptools
# Fedora
sudo dnf install python3-devel
# macOS (using Homebrew)
brew install zlib jpeg
Use the --user parameter to avoid permission issues:
pip install --user pillow
### 2. Import Error
If you encounter errors like `ImportError: cannot import name '_imaging' from 'PIL'`, try:
pip uninstall pillow
pip install --no-cache-dir pillow
### 3. Performance Issues
For large image processing, consider installing the optimized version:
pip install pillow-simd
* * *
## Your First Pillow Program
After successfully installing Pillow, you can start exploring its powerful image processing capabilities:
## Example
from PIL import Image
# Open image
img = Image.open("example.jpg")
# Display image
img.show()
# Convert image format
img.save("example.png")
# Resize
small_img = img.resize((100,100))
small_img.save("small_example.jpg")
**Code Explanation:**
1. **Import Module**
* `from PIL import Image` → Import Pillow's Image module
2. **Open Image**
* `img = Image.open("example.jpg")` → Load the image file from the specified path
* Supported formats: JPG/PNG/GIF/BMP, etc.
3. **Display Image**
* `img.show()` → Open with the system's default image viewer
* For debugging only, not recommended for production environments
4. **Save Image**
* `img.save("example.png")` → Save as the specified format
* Format is determined by the file extension (e.g., .jpg/.png)
5. **Resize**
* `small_img = img.resize((100,100))` → Force resize to 100×100 pixels
* Note: This will change the original image's aspect ratio
6. **Save New Image**
* `small_img.save("small_example.jpg")` → Save the resized image
* You can add a quality parameter to control JPEG quality