Product Page | Docs | Demos | API Reference | Blog | Search | Free Support | Temporary License

GroupDocs.Merger for Python via .NET is a document-manipulation API for combining and reorganizing documents — join multiple files into one, split a document into several, and extract, remove, swap, move, or rotate pages across Word, Excel, PowerPoint, PDF, Visio, images, eBooks, email, and text formats through one unified API.

• Merge / Join: Combine multiple documents of the same family into one — whole files, page subsets, or images.
• Split: Break a document into multiple files by page list or interval; split text by lines.
• Page Management: Extract, remove, swap, move, and rotate pages; change orientation; target odd/even/range subsets.
• Password Protection: Add, change, or remove document passwords; set PDF owner passwords and permissions.
• Document Introspection: Read format, page count, size, and per-page dimensions.
• Page Previews: Render pages to PNG, JPEG, or BMP images.
• OLE & Attachments: Embed spreadsheets, presentations, diagrams, and PDF attachments.
• On-Premise: No cloud or external software required.

GroupDocs.Merger for Python via .NET supports a wide range of file formats, including Word, Excel, PowerPoint, PDF, OpenDocument, Image, Email, and many others. See the full list of supported formats for details.

1. Set Up Environment: Ensure that Python 3.5+ is installed on your system.

2. Get the Code: Clone or download this repository.

   git clone git@github.com:groupdocs-merger/GroupDocs.Merger-for-Python-via-.NET.git

3. Navigate to the Examples Folder

   cd ./GroupDocs.Merger-for-Python-via-.NET/Examples

4. Install Package: install dependencies with pip:

   pip install -r requirements.txt

   Alternatively, download the platform-specific .whl file from the GroupDocs Releases website and install it directly (adjust the filename to your platform — win_amd64, manylinux*_x86_64, macosx_*_arm64, macosx_*_x86_64):

   pip install ./groupdocs_merger_net-26.6-py3-none-win_amd64.whl

5. Configure License (Optional): run_all_examples.py automatically applies a license when one is available, looking in two places:

   • The GROUPDOCS_LIC_PATH environment variable — set it to the absolute path of your .lic file (recommended).
   • Any *.lic file in the repository root.

   With a license applied, examples run with the full feature set; without one, output documents carry an evaluation watermark and are capped at the first two pages. Get a free 30-day temporary license for evaluation.

6. Run the Examples: To run all the examples, execute the following command:

   python ./run_all_examples.py

   You can also run individual examples by navigating to the folder containing the example script and running it. Output files are placed in the same folder as the script file.

The repository ships a Dockerfile that builds a Linux image with Python 3.13, the .NET runtime dependencies (libicu-dev, libgdiplus, libfontconfig1), and the groupdocs-merger-net package preinstalled.

# Build the image
docker build -t merger-examples .

# Run unlicensed (evaluation mode)
docker run --rm merger-examples

# Run with a license mounted from the host
docker run --rm \
    -v /path/to/license:/lic:ro \
    -e GROUPDOCS_LIC_PATH=/lic/your-license.lic \
    merger-examples

On Windows with Git Bash, set export MSYS_NO_PATHCONV=1 before docker run to prevent MSYS from rewriting the mounted license path.

The groupdocs-merger-net wheel ships a bundled AGENTS.md reference for AI coding assistants (Claude Code, Cursor, GitHub Copilot in agent mode, and similar). Once the package is installed, the reference is discovered automatically at groupdocs/merger/AGENTS.md — it covers canonical imports, quick-start usage, licensing, the API surface table, and troubleshooting.

For on-demand documentation lookups, combine the bundled AGENTS.md with the GroupDocs MCP server at https://docs.groupdocs.com/mcp. See the AI agents and LLM integration page for the per-tool setup snippets.

The .github/workflows/ directory contains the CI matrix that runs the full example suite on every push. The matrix is reproducible locally via the Dockerfile above.

Find additional details and examples in the GroupDocs.Merger for Python via .NET documentation.

We also offer GroupDocs.Merger packages for other platforms:

• GroupDocs.Merger for .NET
• GroupDocs.Merger for Java
• GroupDocs.Merger for Node.js via Java

Product Page | Docs | Demos | API Reference | Blog | Search | Free Support | Temporary License