Install GroupDocs.Watermark for Python via .NET
Leave feedback
On this page
GroupDocs.Watermark for Python via .NET is distributed as a pre-built wheel on PyPI. The PyPI index hosts a separate wheel for each supported platform, and pip picks the correct one automatically. Each wheel is self-contained: it bundles the embedded runtime and every managed dependency, so no Microsoft Office, OpenOffice, or separate runtime install is required.
Before you install, review the System Requirements. The wheels need Linux with glibc 2.27 or newer, or macOS 12 or newer, and pip 20.3 or newer to install. On Linux, install ICU, fontconfig, libgdiplus and the Microsoft core fonts; on macOS, install mono-libgdiplus (see Platform Prerequisites).
Install Package from PyPI
Open a terminal and run the install command for your platform:
py-mpipinstallgroupdocs-watermark-net
python3 -m pip install groupdocs-watermark-net
python3 -m pip install groupdocs-watermark-net
After running the command you should see output similar to:
The wheel file name will include a platform suffix that matches your operating system — for example manylinux_2_27_x86_64 on Linux, macosx_12_0_arm64 on Apple Silicon, or win_amd64 on 64-bit Windows.
Add the Package to requirements.txt
For reproducible environments, pin the package version in your requirements.txt:
groupdocs-watermark-net==26.10.0
Then install all dependencies in one step:
pip install -r requirements.txt
Install from a Pre-Downloaded Wheel
If your build environment cannot reach PyPI, download the appropriate wheel from the GroupDocs Releases website and install it locally. Wheels are published for the following four platforms:
Platform
Wheel file name ends with
Oldest system
Windows 64-bit
py3-none-win_amd64.whl
—
Linux x64 (glibc)
py3-none-manylinux_2_27_x86_64.whl
glibc 2.27 (Ubuntu 18.04, Debian 10, RHEL 8)
macOS Apple Silicon (M-series)
py3-none-macosx_12_0_arm64.whl
macOS 12
macOS Intel
py3-none-macosx_12_0_x86_64.whl
macOS 12
Since 26.10 the file names state the oldest system each wheel runs on, so pip 20.3 or newer refuses an older one up front instead of installing a runtime that cannot start. Wheels up to 26.6 were tagged manylinux1_x86_64, macosx_10_14_x86_64 and macosx_11_0_arm64.
Place the downloaded wheel into your project folder, then install it:
Name the wheel file explicitly: PowerShell does not expand a * wildcard for a native command, so pip install groupdocs_watermark_net-*.whl fails there.
On Windows no extra steps are required. On Linux, install ICU, fontconfig, libgdiplus and the Microsoft core fonts; on macOS, mono-libgdiplus. The System Requirements page lists which features need each one.
# Debian: ttf-mscorefonts-installer is in the contrib componentsudo sed -i '/^Components:/s/main/main contrib/' /etc/apt/sources.list.d/debian.sources
sudo apt-get update
sudo apt-get install -y libicu-dev libfontconfig1 libgdiplus ttf-mscorefonts-installer
brew install mono-libgdiplus
Verify the Installation
Confirm the package imported correctly and check the installed version:
python -c "import groupdocs.watermark; print('GroupDocs.Watermark is ready')"
You can also list the installed package with pip show groupdocs-watermark-net to confirm the version and location.
Next Steps
Follow the Hello, World! guide to add your first watermark.