---
id: colorlog
version: "6.12.0"
license: MIT License
license_treatment: permissive
maintenance: active
---

# colorlog — Add colours to the output of Python's logging module.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install colorlog
uv add colorlog
poetry add colorlog

## Description

# Log formatting with colors!

[![](https://img.shields.io/pypi/v/colorlog.svg)](https://pypi.org/project/colorlog/)
[![](https://img.shields.io/pypi/l/colorlog.svg)](https://pypi.org/project/colorlog/)

Add colours to the output of Python's `logging` module.

- [Source on GitHub](https://github.com/borntyping/python-colorlog)
- [Package on PyPI](https://pypi.org/pypi/colorlog/)

## Status

colorlog currently requires Python 3.6 or higher. Older versions (below 5.x.x)
support Python 2.6 and above.

- colorlog 6.x requires Python 3.6 or higher.
- colorlog 5.x is an interim version that will warn Python 2 users to downgrade.
- colorlog 4.x is the final version supporting Python 2.

[colorama] is included as a dependency on Windows, where it is automatically
initialised to support colored output.

This library is over a decade old and supported a wide set of Python versions
for most of its life, which has made it a difficult library to add new features
to. colorlog 6 may break backwards compatibility so that newer features
can be added more easily, but may still not accept all changes or feature
requests. colorlog 4 might accept essential bugfixes but should not be
considered...

## AI interpretation — verify before relying

Adds colored output to Python's logging module, letting you format log messages with ANSI color codes that adapt to terminal capabilities and respect NO_COLOR environment settings.

Verdict: A stable, low-friction choice for adding colors to Python logging. No known vulnerabilities, permissive license, and active maintenance make it safe for production use. The library explicitly trades new features for backwards compatibility, so it is best suited for projects that need reliable colored logging rather than cutting-edge functionality.

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