---
id: hadolint-coatl
version: "2.15.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# hadolint-coatl — Python wrapper around invoking hadolint (https://github.com/hadolint/hadolint)

License: permissive · Maintenance: active · Downloads: 124.8K/mo

## What it is and what it does

hadolint-coatl is a Python wrapper that packages the hadolint Dockerfile linter as a pip-installable tool. Instead of downloading and managing hadolint separately, you install this package and get the hadolint binary available in your environment immediately. The package handles platform detection and downloads the appropriate pre-built binary for macOS, Linux, or Windows during installation.

It's designed for developers and CI/CD pipelines that want to lint Dockerfiles as part of their workflow. The primary use case is integrating hadolint into pre-commit hooks or build processes without requiring manual binary management. Since it has no runtime dependencies, installation is straightforward once the platform-specific binary downloads complete.

Use it for:

- Add hadolint to a pre-commit hook configuration to automatically lint Dockerfiles before commits.
- Include in CI/CD pipelines to validate Dockerfile syntax and best practices as part of build checks.
- Use as a development tool to catch Dockerfile issues locally before pushing to version control.
- Integrate into container image build workflows to enforce Dockerfile quality standards across teams.

## Worth the install?

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

Provides a pip-installable hadolint binary wrapper that makes the Dockerfile linter available as a command-line tool across platforms without requiring separate installation.

Yes, if you need hadolint in a Python-managed environment. The package is actively maintained, has no security vulnerabilities, uses a permissive MIT license, and solves the real problem of making a standalone binary available via pip. The medium install friction is typical for platform-specific tools and not a blocker. Install it when you want hadolint integrated into Python tooling or pre-commit workflows.

## Install

pip install hadolint-coatl
uv add hadolint-coatl
poetry add hadolint-coatl

## Installing hadolint-coatl

Before you install: Medium install friction due to platform-specific binary wheels, but the package is actively maintained with a recent release and no runtime dependencies to resolve.

License in practice: MIT license is permissive; you can use this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install hadolint-coatl
hadolint Dockerfile

Requires Python 3.10 or later; hadolint binary is downloaded during installation for your platform.

Verify before relying:

- Whether the downloaded hadolint binary version matches the package version (2.15.1) or if it can be independently updated.
- Whether the package works correctly on all listed platforms (macOS ARM64, Linux x86_64, Linux aarch64, Windows) in practice.

## Package facts

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

## Tags

dockerfile linter, hadolint wrapper, docker lint tool, pip install hadolint, pre-commit dockerfile, container image validation, docker best practices checker, dockerfile-linting, pre-commit-hook, ci-cd

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