# Install GroupDocs.Watermark for Python via .NET Install GroupDocs.Watermark for Python via .NET on Windows, Linux, or macOS — from PyPI or from a pre-downloaded wheel, including Intel and Apple Silicon builds. GroupDocs.Watermark for Python via .NET is distributed as a pre-built wheel on [PyPI](https://pypi.org/project/groupdocs-watermark-net/). 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. {{< alert style="info" >}} Before you install, review the [System Requirements]({{< ref "watermark/python-net/getting-started/system-requirements.md" >}}). 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](#platform-prerequisites)). {{< /alert >}} ## Install Package from PyPI Open a terminal and run the install command for your platform: {{< tabs "install-pypi">}} {{< tab "Windows" >}} ```ps py -m pip install groupdocs-watermark-net ``` {{< /tab >}} {{< tab "Linux" >}} ```bash python3 -m pip install groupdocs-watermark-net ``` {{< /tab >}} {{< tab "macOS" >}} ```bash python3 -m pip install groupdocs-watermark-net ``` {{< /tab >}} {{< /tabs >}} After running the command you should see output similar to: ```bash 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`: ```txt groupdocs-watermark-net==26.10.0 ``` Then install all dependencies in one step: ```bash 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](https://releases.groupdocs.com/watermark/python-net/) 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: {{< tabs "install-wheel">}} {{< tab "Windows (64-bit)" >}} ```ps py -m pip install .\groupdocs_watermark_net-26.10.0-py3-none-win_amd64.whl ``` {{< /tab >}} {{< tab "Linux (glibc)" >}} ```bash python3 -m pip install ./groupdocs_watermark_net-26.10.0-py3-none-manylinux_2_27_x86_64.whl ``` {{< /tab >}} {{< tab "macOS (Intel)" >}} ```bash python3 -m pip install ./groupdocs_watermark_net-26.10.0-py3-none-macosx_12_0_x86_64.whl ``` {{< /tab >}} {{< tab "macOS (Apple Silicon)" >}} ```bash python3 -m pip install ./groupdocs_watermark_net-26.10.0-py3-none-macosx_12_0_arm64.whl ``` {{< /tab >}} {{< /tabs >}} 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): ```bash 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]({{< ref "watermark/python-net/getting-started/system-requirements.md" >}}) page lists which features need each one. {{< tabs "platform-prereqs">}} {{< tab "Linux" >}} ```bash # 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 ``` {{< /tab >}} {{< tab "macOS" >}} ```bash brew install mono-libgdiplus ``` {{< /tab >}} {{< /tabs >}} ## Verify the Installation Confirm the package imported correctly and check the installed version: ```bash 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!]({{< ref "watermark/python-net/getting-started/hello-world.md" >}}) guide to add your first watermark. - Read the [Features Overview]({{< ref "watermark/python-net/getting-started/features-overview.md" >}}) to see everything you can do. - Clone the [examples repository](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Python-via-.NET) and read [How to Run Examples]({{< ref "watermark/python-net/getting-started/how-to-run-examples.md" >}}) to try every documented scenario locally.