---
id: flake8-html
version: "0.4.3"
license: Apache Software License 2.0
license_treatment: permissive
maintenance: dormant
---

# flake8-html — Generate HTML reports of flake8 violations

License: permissive · Maintenance: dormant · Downloads: 170.3K/mo

## What it is and what it does

flake8-html is a flake8 plugin that transforms linting violations into an interactive HTML report. Instead of reading console output, you run flake8 with the --format=html flag and specify an output directory; the plugin generates a multi-page report with an index page, per-file breakdowns grouped by error code, and syntax-highlighted source listings showing exactly where violations occur.

The package depends on jinja2 for templating, pygments for syntax highlighting, and flake8 itself as the linting engine. It's designed as a drop-in formatter for flake8's reporting pipeline, so once installed, you invoke it purely through flake8's command-line options. The low install friction and permissive license make it straightforward to add to a CI/CD pipeline or local development workflow.

Use it for:

- Generate shareable HTML reports of code style violations for code review or team dashboards
- Create archived snapshots of linting results over time for quality trend tracking
- Provide developers with a visual, clickable interface to navigate and fix style issues in large codebases
- Integrate into CI/CD pipelines to produce human-readable linting artifacts alongside test results
- Display syntax-highlighted violations in a browser for easier identification of problem lines

## Worth the install?

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

A flake8 plugin that converts code style violations into interactive HTML reports with syntax-highlighted source code and grouped error summaries.

Yes, if you need HTML-formatted flake8 reports and are comfortable with dormant maintenance. The package is stable, has no known vulnerabilities, and works with modern Python versions up to 3.9 as of its last release. However, verify compatibility with your specific flake8 version and Python 3.10+ if you use those, since no updates have shipped since 2022.

## Install

pip install flake8-html
uv add flake8-html
poetry add flake8-html

## Installing flake8-html

Before you install: Low install friction with a pure-Python wheel distribution. Maintenance is dormant—last release was 2022-12-06 and no commits since 2024-11-26—but the package remains functional and has no known vulnerabilities.

License in practice: Licensed under Apache Software License 2.0 (permissive), allowing commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install flake8-html
flake8 --format=html --htmldir=flake-report

Verify before relying:

- Whether the package remains compatible with flake8 versions released after 2022-12-06
- Current test coverage and whether it works reliably with modern Python 3.10+ interpreters

## Package facts

- License: Apache Software License 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 170.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

flake8 html report generator, code style violations html, flake8 visual report, python linting html output, flake8 report formatting, code quality html dashboard, flake8 violations visualization, flake8-plugin, code-quality, html-reporting

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