Install GroupDocs.Watermark for Python via .NET

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 -m pip install groupdocs-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:

Collecting groupdocs-watermark-net
  Downloading groupdocs_watermark_net-26.10.0-py3-none-win_amd64.whl (138.9 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 138.9/138.9 MB 3.1 MB/s eta 0:00:00
Installing collected packages: groupdocs-watermark-net
Successfully installed groupdocs-watermark-net-26.10.0

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:

py -m pip install .\groupdocs_watermark_net-26.10.0-py3-none-win_amd64.whl
python3 -m pip install ./groupdocs_watermark_net-26.10.0-py3-none-manylinux_2_27_x86_64.whl
python3 -m pip install ./groupdocs_watermark_net-26.10.0-py3-none-macosx_12_0_x86_64.whl
python3 -m pip install ./groupdocs_watermark_net-26.10.0-py3-none-macosx_12_0_arm64.whl

Name the wheel file explicitly: PowerShell does not expand a * wildcard for a native command, so pip install groupdocs_watermark_net-*.whl fails there.

Expected output (Linux):

Processing ./groupdocs_watermark_net-26.10.0-py3-none-manylinux_2_27_x86_64.whl
Installing collected packages: groupdocs-watermark-net
Successfully installed groupdocs-watermark-net-26.10.0

Platform Prerequisites

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 component
sudo 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