humanize

Python humanize utilities

humanize Permissive license MIT Active ★ 746 v4.16.0 released 2026-06-30

Install

humanize on PyPI

pip

pip install humanize

uv

uv add humanize

poetry

poetry add humanize

Package facts

License	MIT (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	none
Maintenance	actively maintained — 44 days since the last release
Last repo commit	2026-08-01
First released	2011-10-12
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: humanize-4.16.0-py3-none-any.whl

Keywords: humanize, time, size

Development Status :: 5 - Production/StableIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.15Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Text ProcessingTopic :: Text Processing :: General

About humanize

from the package's own PyPI description — quoted content, verbatim

humanize

PyPI version (image) Supported Python versions (image) Documentation Status (image) PyPI downloads (image) GitHub Actions status (image) codecov (image) MIT License (image) Tidelift (image)

This modest package contains various common humanization utilities, like turning a number into a fuzzy...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Converts numbers, dates, times, and file sizes into human-readable strings with support for 30+ locales—e.g., turning a number into '12,345' or a timedelta into '3 minutes ago'.

Installs cleanly with no runtime dependencies and zero friction. Actively maintained with a recent release 44 days ago and steady commit activity.

MIT license permits commercial and private use with minimal restrictions—you may use, modify, and distribute freely as long as you include the license notice.

Usage

pip install humanize
import humanize
import datetime as dt
humanize.naturaltime(dt.datetime.now() - dt.timedelta(seconds=3))
# Output: '3 seconds ago'

Requires Python 3.10 or later.

Verdict: A mature, zero-dependency utility for formatting numbers and dates into readable strings across 30+ languages. MIT-licensed, actively maintained, and widely used (top_1000 tier). No known vulnerabilities and straightforward installation make it a reliable choice for UI and logging tasks.