Skip to main content

hugo-python-distributions

Classifiers Description
Builds Actions Status for CI Actions status for CD pre-commit.ci status
Package PyPI version PyPI - Python Version Downloads Downloads per month Downloads per week Downloads per day PiWheels version
Meta License Hugo version Documentation prek Ruff

Binaries for the extended + withdeploy edition of the Hugo static site generator, installable via pip

This project provides wheels for Hugo so that it can be used with pip on macOS, Linux, and Windows; for Python 3.10 and later.

What is Hugo?

Hugo is a static site generator written in Go. It is designed to be fast and flexible, and it is used by many people and organizations for their websites, documentation, and personal blogs.

What version of hugo do I install?

This project, hugo is versioned alongside the Hugo releases and is aligned with the versioning of Hugo itself, which uses SemVer – but is likely versioned according to 0ver software standards based on their versioning history.

Binaries for hugo through these wheels are available for Hugo versions 0.121.2 and above, through PyPI or through releases on GitHub. If you need an older version of hugo that is not available through this package, please consider using the official Hugo binaries.

Please refer to the section on Supported platforms for a list of wheels available for supported platforms and architectures. If it does, jump to the Quickstart section to get started.

Documentation

The documentation for this project is available at https://agriyakhetarpal.github.io/hugo-python-distributions/

Background

Binaries for the Hugo static site generator are available for download from the Hugo releases page. These binaries have to be downloaded and placed in an appropriate location on the system manually and the PATH environment variable has to be updated to include said location.

This project provides wheels for Hugo to be used with pip on macOS, Linux, and Windows. This allows Hugo to be installed and used in a virtual environment, which allows multiple versions of Hugo to be installed and used side-by-side in different virtual environments, where Hugo can be used as a command-line tool (a Python API is not provided at this time given the lack of such a demand for it).

Use cases

This project is designed to be used in the following scenarios:

  • You want to use Hugo as a command-line tool, but you don't want it to be installed globally on your system or do not have the necessary permissions to do so.
  • You cannot or do not want to use the official Hugo binaries
  • You want to use Hugo in a virtual environment that is isolated from the rest of your system – this also allows you to install and use multiple versions of Hugo side-by-side if needed for any reason
  • You want to use Hugo in a Python-based project, such as a static site generator that uses Hugo as a backend?
  • You want to test a new version of Hugo without having to install it globally on your system or affecting your existing Hugo installation
  • Python wheels allow for incredibly fast installation, in comparison to using other methods of installing Hugo such as system package managers
  • Easy updates to the latest version of Hugo through the use of the pip install --upgrade hugo command, and automatic updates possible too if you use a package manager such as Poetry or PDM to manage your Python dependencies or a tool such as pipx to manage your command-line tools
  • ...and more!

(Known) limitations

  • It is difficult to provide wheels for all platforms and architectures (see Supported platforms), so this project only provides wheels for the most common ones—those supported by Python platform tags, packaging standards and tooling—it is not reasonable to do so and provide releases for other platforms owing to the limited resources available on CI systems, in this case, GitHub Actions runners. For extra platforms and architectures, please refer to the Building from source section or consider using the official Hugo binaries for your purpose.
  • This project does not provide a Python API for Hugo, it just wraps its own command-line interface. The packaging infrastructure for this Python package is not designed to provide a Python API for Hugo, and it is not the goal of this project to provide one. If you need a Python API for Hugo, please refer to the Hugo documentation for further resources on how to use Hugo programmatically as needed.

Licensing

This project is licensed under the terms of the Apache 2.0 license. Hugo is available under Apache 2.0 (see the Hugo license) as well.

Security

Please refer to the Security policy for this project for more information.

Code of Conduct

This repository aims to follow the Hugo project in striving to provide a welcoming and inclusive environment for all contributors, regardless of their background and identity. Please refer to the Code of Conduct for more information that applies to all interactions in this repository and its associated spaces. It is reliant on the Contributor Covenant for its guidelines and conforms to version 2.1.

For requesting help, reporting bugs, or requesting features that are specific to Hugo's functionalities, please refer to the Hugo Discourse forum. For requesting help for hugo-python-distributions, please feel free to open an issue in this repository.

Inspirations for this project, and similar projects

Binaries

  • The official Hugo project, which is the source of the binaries provided by this project.

Naming

  • The cmake-python-distributions project by the scikit-build team provides a similar infrastructure for building and distributing CMake as a Python package to be used as a PEP 517 build-time dependency for building packages with extension modules. I used their repository's name as an inspiration for the name of this repository.

Other distributors of Hugo

  • uhugo is a Hugo binary helper that installs and updates Hugo binaries from Hugo official releases. It can be used to update the version of Hugo within Cloud providers. The difference between uHugo is that this project enables building Hugo from source and embeds the application binary into a wheel, while uHugo is a CLI to update an existing Hugo binary already present on PATH. It provides similar visions for installing Hugo via a command-line interface, even though the idea and the packaging code is fundamentally different.
  • hvm (Hugo version manager) is a project by one of the core developers of Hugo that allows downloading multiple Hugo versions and setting different default versions by adding them to PATH, thereby allowing the usage of multiple versions at once, but without the extra Python scaffolding provided here (and without pipx's run-without-install functionality of course).
  • hugo-installer is a small Node.js script which you can use to fetch the correct Hugo binary for your system and install it with npm's post-installation hook. It is similar to this project in that it provides a way to install Hugo binaries.
  • conda-forge's hugo feedstock provides a way to install Hugo binaries via the conda package format and associated package managers.

Similar projects that distribute binaries embedded in Python packages

  • zig-pypi is a project that provides a way to distribute the Zig compiler as a Python package, which can be installed via pip. It provides a similar infrastructure for building and distributing binaries as this project does for Hugo, but it fetches the Zig compiler binaries from the official Zig releases and embeds them into a Python package in a reproducible manner.
  • nodejs-wheel is a project that provides a way to unofficially distribute Node.js binaries as Python packages, which can be installed via pip, in order to use Node.js and npm in an isolated Python environment.
  • The pip-binary-factory repository provides binaries and their CLIs for various Go-based tools as Python packages.

There are several other projects in this area, but are not listed here for brevity.

Footnotes

  • This project is currently not affiliated with the official Hugo project. Please refer to the Hugo documentation for more information on Hugo.
  • The author of this project: @agriyakhetarpal, would like to express a token of gratitude to the owner of the Hugo package on PyPI (@nariman) for their kind gesture of granting access to take over the package name with the underlying provisions of PEP 541. This way, it allows users to install the package using the same name as the official Hugo project, which undoubtedly provides for a better user experience and convenience to users of this package when compared to the previous package name, python-hugo.

Metadata

Release files for hugo 0.167.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hugo 0.167.0
File Size Uploaded
hugo-0.167.0.tar.gz 4.7 MB Details

Built distributions (wheels)

Table of built distributions (wheels) for hugo 0.167.0
File
hugo-0.167.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details
hugo-0.167.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
hugo-0.167.0-py3-none-win32.whl Python 3 none Windows x86-32 Details
hugo-0.167.0-py3-none-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details
hugo-0.167.0-py3-none-manylinux_2_24_s390x.manylinux_2_28_s390x.whl Python 3 none Linux glibc 2.24+ IBM System/390x, Linux glibc 2.28+ IBM System/390x Details
hugo-0.167.0-py3-none-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl Python 3 none Linux glibc 2.24+ PowerPC 64-le, Linux glibc 2.28+ PowerPC 64-le Details
hugo-0.167.0-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64, Linux glibc 2.24+ ARM64 Details
hugo-0.167.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
hugo-0.167.0-py3-none-macosx_10_15_x86_64.whl Python 3 none macOS 10.15+ x86-64 Details

Total release size: 269.0 MB

Release files / hugo-0.167.0.tar.gz

Download URL hugo-0.167.0.tar.gz
Size 4.7 MB
Tags Source
SHA-256 checksum
How to use checksums
7814e2666113c752897f9301bc9bf8ac6128d1637c4435e1bfc7299f60435a4d
BLAKE2b-256 checksum
How to use checksums
39af43934c9d8e0d4d77fa8af5815239e1a0dedae58e9800a72f340f5b1f3fee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / hugo-0.167.0-py3-none-win_arm64.whl

Download URL hugo-0.167.0-py3-none-win_arm64.whl
Size 28.7 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
eaa1c10212b09d5278c7e4a55767b7d96555ea536ac7a9a572545002b79e4cf2
BLAKE2b-256 checksum
How to use checksums
6ff725de71961b3a520c3276781bc9e885ab61130c80ce0420ee0d47f2e48fc7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / hugo-0.167.0-py3-none-win_amd64.whl

Download URL hugo-0.167.0-py3-none-win_amd64.whl
Size 32.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
3f479c9ee76aecb981b95004beafb6e415332491e45f81bbd538d17c4f4d520f
BLAKE2b-256 checksum
How to use checksums
548539f8426a6b29bb4a9f8e564cd79bc682957f117e4a9f7516037a1342e7ad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / hugo-0.167.0-py3-none-win32.whl

Download URL hugo-0.167.0-py3-none-win32.whl
Size 30.0 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
d4ec77c825ed38bc047a2c197f0ef03d3cc7109490536a4321e8645eb7260a9c
BLAKE2b-256 checksum
How to use checksums
86133ec947e454910bc94b465216ed82f51e9290fe8fc44d4f54264531cc3515
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / hugo-0.167.0-py3-none-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl

Download URL hugo-0.167.0-py3-none-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Size 30.3 MB
Tags Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
ef515d153184047086e35216c53bb345f780e833181a6556d6a50bd840b9caf2
BLAKE2b-256 checksum
How to use checksums
2e476926aac2102fd40476222c9e7769574ef7acb8f39c2a8ca001f6fcb8c72d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / hugo-0.167.0-py3-none-manylinux_2_24_s390x.manylinux_2_28_s390x.whl

Download URL hugo-0.167.0-py3-none-manylinux_2_24_s390x.manylinux_2_28_s390x.whl
Size 29.7 MB
Tags Linux glibc 2.24+ IBM System/390x Linux glibc 2.28+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
86770808e851894f68a3c8fb5bbcbce1450f512f8f7e15e0192326c1567fce3c
BLAKE2b-256 checksum
How to use checksums
5f4110c5c8200e0aa3500eb061d8629ad8abe3cbd81b1f624b55ca42b938dc22
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / hugo-0.167.0-py3-none-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl

Download URL hugo-0.167.0-py3-none-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl
Size 27.4 MB
Tags Linux glibc 2.24+ PowerPC 64-le Linux glibc 2.28+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
df389f682bcf77cc658118aa973f7916603bfac041ce25a4aeb6f3556b7d6da9
BLAKE2b-256 checksum
How to use checksums
050a679103f87d2df4e516bf56dbf4776c9f0005580b1bf5ef8d13cd5402a025
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / hugo-0.167.0-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl

Download URL hugo-0.167.0-py3-none-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
Size 27.6 MB
Tags Linux glibc 2.24+ ARM64 Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
d9639c48438c9f56872fa94fe4eb3f8873db37a25f69c3097150084041756fb8
BLAKE2b-256 checksum
How to use checksums
fd039483b1c1214a3c8d50c1b26e7d0ea9cbc6fc4ee8caeb1b42f8ca04c9ed72
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / hugo-0.167.0-py3-none-macosx_11_0_arm64.whl

Download URL hugo-0.167.0-py3-none-macosx_11_0_arm64.whl
Size 28.3 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
2e49976cec3c468ea137e7ab302068e5bca58b37967f5c8d002a1cf47045a1c3
BLAKE2b-256 checksum
How to use checksums
8b028d1d07f40cd176cb62f40daf041919f012ee68af0e7024e936e66bee8e5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / hugo-0.167.0-py3-none-macosx_10_15_x86_64.whl

Download URL hugo-0.167.0-py3-none-macosx_10_15_x86_64.whl
Size 30.3 MB
Tags Python 3 macOS 10.15+ x86-64
SHA-256 checksum
How to use checksums
7e29dcc858f6baab4c7e6107eb18408bf71bbe37ec9572dd6c070403b6a3aeb9
BLAKE2b-256 checksum
How to use checksums
12c612489520ce81a2dd76719482a14e9d69bce19841273e53eadb4cbb9560e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.167.0 This release

10 release files

0.147.7

1 release file

0.147.6

1 release file

0.147.5

1 release file

0.147.4

1 release file

0.147.3

1 release file

0.147.0

1 release file

0.146.7

1 release file

0.146.6

1 release file

0.146.5

1 release file

0.146.4

1 release file

0.146.3

1 release file

0.146.2

1 release file

0.146.1

1 release file

0.146.0

1 release file

0.145.0

1 release file

0.144.2

1 release file

0.144.1

1 release file

0.144.0

1 release file

0.142.0

1 release file

0.141.0

1 release file

0.140.2

1 release file

0.140.1

1 release file

0.140.0

1 release file

0.139.5

1 release file

0.139.3

1 release file

0.139.2

1 release file

0.139.1

1 release file

0.139.0

1 release file

0.136.5

1 release file

0.136.4

1 release file

0.136.3

1 release file

0.136.2

1 release file

0.136.1

1 release file

0.136.0

1 release file

0.135.0

1 release file

0.134.3

1 release file

0.134.2

1 release file

0.133.1

1 release file

0.133.0

1 release file

0.132.2

1 release file

0.132.1

1 release file

0.132.0

1 release file

0.130.0

1 release file

0.129.0

1 release file

0.128.0

1 release file

0.126.2

1 release file

0.126.1

1 release file

0.126.0

1 release file

0.125.4

1 release file

0.125.3

1 release file

0.125.2

1 release file

0.125.1

1 release file

0.125.0

1 release file

0.124.1

1 release file

0.124.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page