Installation

Before installing, check the System Requirements for supported Python versions and platform dependencies.

Install Package from PyPI

The library is published on PyPI as groupdocs-viewer-net. pip automatically selects the right platform-specific wheel for your system.

Install the Latest Version

py -m pip install groupdocs-viewer-net
python3 -m pip install groupdocs-viewer-net
python3 -m pip install groupdocs-viewer-net

You should see output similar to:

Collecting groupdocs-viewer-net
  Downloading groupdocs_viewer_net-<version>-py3-none-win_amd64.whl.metadata (6.8 kB)
  Downloading groupdocs_viewer_net-<version>-py3-none-win_amd64.whl (193 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 193/193 MB 2.8 MB/s
Installing collected packages: groupdocs-viewer-net
Successfully installed groupdocs-viewer-net-<version>

The exact wheel name depends on your OS and CPU architecture — see the wheel-suffix table in System Requirements for the complete list.

Add the Package to requirements.txt

Add the dependency to your project’s requirements.txt:

groupdocs-viewer-net

Then install from the file:

pip install -r requirements.txt

Pin to a specific version if you need reproducible builds — for example, groupdocs-viewer-net==26.9.0.

Install from a Pre-Downloaded Wheel

For air-gapped or controlled environments, download the wheel from the GroupDocs Releases site or the PyPI release page and install it directly. Four platform-specific wheels are published per release; pick the one that matches your host:

  • Windows x86-64 — groupdocs_viewer_net-<version>-py3-none-win_amd64.whl
  • Linux x86-64 — groupdocs_viewer_net-<version>-py3-none-manylinux_2_27_x86_64.whl (glibc 2.27 or newer)
  • macOS Apple Silicon (ARM64) — groupdocs_viewer_net-<version>-py3-none-macosx_12_0_arm64.whl (macOS 12 or newer)
  • macOS Intel (x86-64) — groupdocs_viewer_net-<version>-py3-none-macosx_12_0_x86_64.whl (macOS 12 or newer)

Since 26.9 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.5 were tagged manylinux1_x86_64, macosx_10_14_x86_64 and macosx_11_0_arm64.

Copy the downloaded wheel into your project folder and install it with pip:

py -m pip install groupdocs_viewer_net-26.9.0-py3-none-win_amd64.whl
python3 -m pip install ./groupdocs_viewer_net-26.9.0-py3-none-manylinux_2_27_x86_64.whl
python3 -m pip install ./groupdocs_viewer_net-26.9.0-py3-none-macosx_12_0_arm64.whl
python3 -m pip install ./groupdocs_viewer_net-26.9.0-py3-none-macosx_12_0_x86_64.whl

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

Expected output:

Processing ./groupdocs_viewer_net-26.9.0-py3-none-manylinux_2_27_x86_64.whl
Installing collected packages: groupdocs-viewer-net
Successfully installed groupdocs-viewer-net-26.9.0

Next Steps

  • Quick Start Guide — render your first document in five minutes.
  • How to Run Examples — clone the runnable examples repository and execute every documented scenario.
  • Agents and LLMs — use GroupDocs.Viewer with AI coding assistants through the MCP server and the package-bundled AGENTS.md.