Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

nvchecker (short for new version checker) is for checking if a new version of some software has been released.

This is the version 2.0 branch. For the old version 1.x, please switch to the v1.x branch.

Test Status PyPI version Documentation Status

Packaging status


  • Python 3.7+
  • Python library: structlog, tomli, platformdirs
  • One of these Python library combinations (ordered by preference):
    • tornado + pycurl
    • aiohttp
    • httpx with http2 support (experimental; only latest version is supported)
    • tornado
  • All commands used in your software version configuration files

Install and Run

To install:

pip3 install nvchecker

To use the latest code, you can also clone this repository and run:

pip install .

To see available options:

nvchecker --help

Run with one or more software version files:

nvchecker -c config_file

You normally will like to specify some "version record files"; see below.


For detailed documentation, see