Install GroupDocs.Assembly for Python via .NET Leave feedback

GroupDocs.Assembly 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 .NET 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 64-bit Python 3.5-3.14 and pip 20.3 or newer, and run on Windows, on Linux with glibc 2.27 or newer, and on macOS 12 or newer. On Linux, install ICU, libgdiplus and fonts; on macOS, install mono-libgdiplus (see Platform Prerequisites).

Open a terminal and run the install command for your platform:

py -m pip install groupdocs-assembly-net

python3 -m pip install groupdocs-assembly-net

python3 -m pip install groupdocs-assembly-net

After running the command you should see output similar to:

Collecting groupdocs-assembly-net
  Downloading groupdocs_assembly_net-26.11.0-py3-none-win_amd64.whl (81.1 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 81.1/81.1 MB 3.1 MB/s eta 0:00:00
Installing collected packages: groupdocs-assembly-net
Successfully installed groupdocs-assembly-net-26.11.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.

For reproducible environments, pin the package version in your requirements.txt:

groupdocs-assembly-net==26.11.0

Then install all dependencies in one step:

pip install -r requirements.txt

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:

The file names state the oldest system each wheel runs on, so pip 20.3 or newer refuses a wheel the system cannot run. There is no 32-bit wheel.

Place the downloaded wheel into your project folder, then install it:

py -m pip install .\groupdocs_assembly_net-26.11.0-py3-none-win_amd64.whl

python3 -m pip install ./groupdocs_assembly_net-26.11.0-py3-none-manylinux_2_27_x86_64.whl

python3 -m pip install ./groupdocs_assembly_net-26.11.0-py3-none-macosx_12_0_x86_64.whl

python3 -m pip install ./groupdocs_assembly_net-26.11.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_assembly_net-*.whl fails there.

Expected output (Linux):

Processing ./groupdocs_assembly_net-26.11.0-py3-none-manylinux_2_27_x86_64.whl
Installing collected packages: groupdocs-assembly-net
Successfully installed groupdocs-assembly-net-26.11.0

If pip reports is not a supported wheel on this platform, pip is older than 20.3 or the system is older than the wheel needs: run python -m pip install --upgrade pip first. Python 3.5 needs pip 20.3.4, the last release for it. On an Intel Mac, a Python built against an old SDK reports macOS 10.16; use pip 24.1 or newer, or SYSTEM_VERSION_COMPAT=0 pip install ....

GroupDocs.Assembly for Python via .NET 25.5 shipped Windows wheels only, for 32-bit and 64-bit Python. 26.11 adds Linux and macOS, supports Python 3.5 to 3.14, and takes Python dicts and lists as data sources; it has no 32-bit Windows wheel. Upgrade in place:

python -m pip install --upgrade groupdocs-assembly-net

On Windows no extra steps are required. On Linux, install ICU, libgdiplus and the fonts your templates use; on macOS, mono-libgdiplus. The System Requirements page explains what each one is for.

sudo apt-get update
sudo apt-get install -y libicu-dev libgdiplus fontconfig ttf-mscorefonts-installer

brew install mono-libgdiplus

ICU is required: without it the process aborts at the first call into the engine. libgdiplus serves presentations: without it, a PowerPoint or OpenDocument presentation template cannot be filled.

Confirm the package imported correctly:

python -c "import groupdocs.assembly; print('GroupDocs.Assembly is ready')"

You can also list the installed package with pip show groupdocs-assembly-net to confirm the version and location.

The first call into the engine takes about a second. On Windows, when a license is applied, the first call in a process takes 15-30 seconds: that is the engine’s license check, which runs once per process.

• Follow the Hello, World! guide to build your first report.
• Read the Features Overview to see everything you can do.
• Clone the examples repository and read How to Run Examples to try every documented scenario locally.