Product Page | Docs | Release Notes | Examples | Blog | Free Support | Temporary License

GroupDocs.Total for Python via .NET

groupdocs-total-net is a metapackage. It installs the 14 GroupDocs for Python via .NET products below with one command and holds no code of its own. Each product is a self-contained wheel with its own .NET runtime, and you import it from its own package: groupdocs.conversion, groupdocs.viewer, groupdocs.parser and so on.

Install

pip install groupdocs-total-net==26.11.0

The 14 product wheels download about 2.2 GB on every platform and take about 3.2 GB on disk. pip 20.3 or later is needed.

Products

Each product's own page on PyPI, its Docs and its release notes describe its API, formats and requirements.

Using several products in one script

Products can be combined in one Python process. On Windows, set DOTNET_MULTILEVEL_LOOKUP to 0 at the top of the script, before the first call into any product:

import os

os.environ["DOTNET_MULTILEVEL_LOOKUP"] = "0"  # Windows: every product keeps its own .NET runtime

from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions
from groupdocs.watermark import Watermarker
from groupdocs.watermark.watermarks import TextWatermark, Font

with Converter("document.docx") as converter:
    converter.convert("document.pdf", PdfConvertOptions())

with Watermarker("document.pdf") as watermarker:
    watermarker.add(TextWatermark("CONFIDENTIAL", Font("Arial", 36.0)))
    watermarker.save("watermarked.pdf")

Each product brings its own .NET runtime. Without the setting, on a Windows machine with a newer .NET installed system-wide, Viewer, Metadata, Annotation, Comparison, Editor, Merger and Redaction load that runtime instead of their own, and the second of them in one process fails with RuntimeError: hostfxr_get_runtime_delegate failed with 0x800080a3. The setting has no effect on Linux and macOS.

System requirements

• Python 3.5 to 3.14, 64-bit.
• Windows x64.
• Linux x86_64 with glibc 2.27 or later, ICU (libicu), and fontconfig with fonts for the products that render documents. Some products also need libgdiplus; each product's system requirements page lists its own.
• macOS 13 or later, on Intel or Apple Silicon. On an Intel Mac whose Python reports macOS 10.16, use pip 24.1 or later.

No Microsoft Office, OpenOffice or separately installed .NET runtime is needed.

Licensing

Without a licence every product runs in evaluation mode, with limits that each product's Docs describe. A GroupDocs.Total licence covers all 14 products. Set it once for every product:

export GROUPDOCS_LIC_PATH="/path/to/GroupDocs.Total.lic"

Each product applies the licence at its first call. A licence URL works too. Alternatively, call License().set_license(path) from the product you use, for example from groupdocs.conversion import License.

Shared modules

Every product wheel also installs three small shared modules: groupdocs/__init__.py, groupdocs/pydrawing (the Color, Point and Size types the products accept) and groupdocs/pycore. Uninstalling one product removes them for all the others, and from groupdocs.viewer import Color then fails. Reinstall one product without its dependencies to restore them:

pip install --force-reinstall --no-deps groupdocs-viewer-net==26.9.0

On Python 3.5, run the same command after installing: the copy of groupdocs/pydrawing that pip installs last does not compile there.

Product Page | Docs | Release Notes | Examples | Blog | Free Support | Temporary License