---
id: allure-combine
version: "1.0.11"
license: MIT
license_treatment: permissive
maintenance: aging
---

# allure-combine — Generate single HTML file from allure report.

License: permissive · Maintenance: aging · Downloads: 378.9K/mo

## What it is and what it does

allure-combine takes a folder generated by Allure's test reporting tool and bundles it into a single complete.html file. The tool reads the Allure report contents, embeds all data files and JavaScript (including a fake XHR server and sinon-9.2.4.js), and patches the index.html so the report can be opened directly in any browser without needing special Chrome flags or a local web server.

You can use it as a command-line tool or import it into Python code. It supports options to specify output folders, auto-create destination directories, clean up temporary files, and handle UTF-8 encoding issues. The result is a portable, shareable HTML file suitable for archiving or distributing test results.

Use it for:

- Archive test reports as standalone files without needing to maintain a report server or folder structure.
- Share Allure test results with stakeholders via email or file transfer without requiring them to set up infrastructure.
- Generate offline-readable test reports for CI/CD pipelines that need to produce deliverable artifacts.
- Bundle test results into a single file for version control or long-term storage alongside code.
- Distribute test reports to teams or clients who need to review results in a browser without command-line tools.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts an Allure test report folder into a single self-contained HTML file that can be opened in any browser without special flags or a local server.

Yes, if you use Allure for test reporting and need portable, single-file HTML reports. The package is straightforward, has low install friction, carries a permissive license, and has no known vulnerabilities. However, be aware the project is aging (last release June 2023) and some features like image/video viewing are not yet implemented—verify compatibility with your Allure version and browser environment before relying on it in production workflows.

## Install

pip install allure-combine
uv add allure-combine
poetry add allure-combine

## Installing allure-combine

Before you install: Low friction install with a single runtime dependency (bs4). Package is aging—last release was over a year ago and the repository shows no recent commits, though it remains unarchived and has modest GitHub activity (97 stars).

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart:

pip install allure-combine

from allure_combine import combine_allure
combine_allure("./allure-report-folder")

Requires an existing Allure report folder generated by the Allure command-line tool (allure generate).

Verify before relying:

- Whether image and video functionality in the generated HTML works as expected (documentation notes this is not yet implemented).
- Current status of the package's compatibility with recent Allure versions and modern browser security policies.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 378.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

allure report single html file, combine allure generated folder, allure offline html export, standalone allure report, allure html bundler, convert allure to single file, allure report packaging, test-reporting, allure-integration, html-generation

[View on SkillFed](https://skillfed.io/packages/allure-combine) · [View on PyPI](https://pypi.org/project/allure-combine/)