GroupDocs.Assembly for Python via .NET - Code Examples

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

GroupDocs.Assembly for Python via .NET is a document automation and report generation API: it fills templates - Word, Excel, PowerPoint, OpenDocument, email, HTML, Markdown and text documents with tags such as <<[customer.Name]>> - with data from Python dicts and lists, JSON, XML and CSV files, or the tables of other documents, and saves the reports as DOCX, XLSX, PPTX, PDF, HTML, email and more, with no Microsoft Office or other external software required.

Features

• Python Data as It Is: Dicts and lists, with their numbers, strings, dates and Decimal values, are read by the template's tags as objects.
• Data Files and Documents: JSON, XML and CSV files, and the tables of Word, Excel and PowerPoint documents, as data sources.
• Template Syntax: Expressions, formatting and data bands, with Sum, Where, GroupBy and OrderBy written in the template.
• Every Kind of Report: Tables, lists, charts, images, barcodes, hyperlinks, bookmarks, check boxes and inserted documents.
• Email: Messages whose sender, recipients, subject and body come from data.
• Any Output Format: A report in the template's format, or a Word template saved as PDF, HTML, XPS or Markdown.
• On-Premise: No MS Office or OpenOffice installation required.

Supported File Formats

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

Get Started

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-assembly/GroupDocs.Assembly-for-Python-via-.NET.git

3. Navigate to the Examples Folder

   cd ./GroupDocs.Assembly-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_assembly_net-26.11.0-py3-none-win_amd64.whl

5. Configure License (Optional): run_all_examples.py applies a license automatically when the GROUPDOCS_LIC_PATH environment variable holds the absolute path of your .lic file.

   With a license applied, examples run with the full feature set; without one, every report carries an evaluation mark, and a report stops after about 200 paragraphs. 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.

Run with Docker

The repository ships a Dockerfile that builds a Linux image with Python 3.13, the system packages the examples need (libicu-dev, libgdiplus, fontconfig, ttf-mscorefonts-installer), and the groupdocs-assembly-net package preinstalled.

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

# Run unlicensed (evaluation mode)
docker run --rm assembly-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 \
    assembly-examples

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

AI agents and LLM integration

The groupdocs-assembly-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/assembly/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.

Continuous integration

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.

More Resources

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

We also offer GroupDocs.Assembly packages for other platforms:

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

---

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