https://github.com/agriyakhetarpal/hugo-python-distributions
pip-installable binaries (wheels) for the "extended + withdeploy" edition of the Hugo static site generator with powerful cross-compilation (note: unofficial, community-maintained)
https://github.com/agriyakhetarpal/hugo-python-distributions
blog-engine cms content-management-system documentation go golang hacktoberfest hugo pipx pypi python python-app python-package python-wheels static-site static-site-generation static-site-generator static-website static-website-generator uvx
Last synced: 16 days ago
JSON representation
pip-installable binaries (wheels) for the "extended + withdeploy" edition of the Hugo static site generator with powerful cross-compilation (note: unofficial, community-maintained)
- Host: GitHub
- URL: https://github.com/agriyakhetarpal/hugo-python-distributions
- Owner: agriyakhetarpal
- License: apache-2.0
- Created: 2024-01-01T13:04:26.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-08T13:35:17.000Z (8 months ago)
- Last Synced: 2025-09-21T05:50:52.246Z (7 months ago)
- Topics: blog-engine, cms, content-management-system, documentation, go, golang, hacktoberfest, hugo, pipx, pypi, python, python-app, python-package, python-wheels, static-site, static-site-generation, static-site-generator, static-website, static-website-generator, uvx
- Language: Python
- Homepage: https://pypi.org/project/hugo/
- Size: 699 KB
- Stars: 16
- Watchers: 3
- Forks: 1
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# hugo-python-distributions
[actions-badge]: https://github.com/agriyakhetarpal/hugo-python-distributions/workflows/CI/badge.svg
[cd-badge]: https://github.com/agriyakhetarpal/hugo-python-distributions/workflows/CD/badge.svg
[actions-link]: https://github.com/agriyakhetarpal/hugo-python-distributions/actions
[pypi-link]: https://pypi.org/project/hugo/
[pypi-platforms]: https://img.shields.io/pypi/pyversions/hugo/
[pypi-version]: https://img.shields.io/pypi/v/hugo/
[pypi-downloads-total]: https://img.shields.io/pepy/dt/hugo
[pypi-downloads-monthly]: https://img.shields.io/pypi/dm/hugo
[pypi-downloads-weekly]: https://img.shields.io/pypi/dw/hugo
[pypi-downloads-daily]: https://img.shields.io/pypi/dd/hugo
[license-badge]: https://img.shields.io/pypi/l/hugo?color=lavender
[license-link]: https://apache.org/licenses/LICENSE-2.0
[hugo-badge]: https://img.shields.io/badge/hugo-extended,withdeploy-pink.svg?style=flat&logo=hugo
[hugo-link]: https://gohugo.io/
[docs-link]: https://github.com/agriyakhetarpal/hugo-python-distributions/
[docs-badge]: https://img.shields.io/badge/docs-read%20on%20GitHub-blue.svg?style=flat&logo=github
| Classifiers | Description |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Builds | [![Actions Status for CI][actions-badge]][actions-link] [![Actions status for CD][cd-badge]][actions-link] [](https://results.pre-commit.ci/latest/github/agriyakhetarpal/hugo-python-distributions/main) |
| Package | [](https://badge.fury.io/py/hugo)  [](https://pepy.tech/project/hugo) [](https://pepy.tech/project/hugo) [](https://pepy.tech/project/hugo) [](https://pepy.tech/project/hugo) |
| Meta | [![License][license-badge]][license-link] [![Hugo version][hugo-badge]][hugo-link] [![Documentation][docs-badge]][docs-link] [](https://github.com/j178/prek) [](https://github.com/astral-sh/ruff) |
Binaries for the **`extended` + `withdeploy` edition** of the Hugo static site generator, installable via `pip`
This project provides wheels for [Hugo](https://gohugo.io/) so that it can be used with `pip` on macOS, Linux, and Windows; for Python 3.10 and later.
> [!NOTE]
> Only the latest, stable, and to-be EOL Python versions are tested regularly. If you encounter any issues with the package on a specific Python version, please feel free to [open an issue](https://github.com/agriyakhetarpal/hugo-python-distributions/issues/new).
## What is Hugo?
[Hugo](https://gohugo.io/) is a static site generator written in [Go](https://golang.org/). It is designed to be fast and flexible, and it is used by many people and organizations for their websites, documentation, and personal blogs.
> [!NOTE]
> This distribution of `Hugo` is currently not affiliated with the official `Hugo` project. Please refer to the [Hugo documentation](https://gohugo.io/documentation/) for more information on Hugo.
## 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](https://0ver.org/) software standards based on their [versioning history](https://github.com/gohugoio/hugo/releases).
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](https://github.com/gohugoio/hugo/releases).
Please refer to the section on [Supported platforms](#supported-platforms) for a list of wheels available for supported platforms and architectures. If it does, jump to the [Quickstart](#quickstart) section to get started.
> [!WARNING]
> Owing to the limitations of overall sizing available on [PyPI](https://pypi.org/project/hugo/#history) for `hugo`, only the most recent versions of Hugo are available for download through `pip`, and older versions of these wheels will be deleted to make space for newer releases. If you need an older version of Hugo, please consider using the wheels that have been uploaded to the [GitHub releases](https://github.com/agriyakhetarpal/hugo-python-distributions/releases) page or the [official Hugo binaries](https://github.com/gohugoio/hugo/releases). The former can be done via `pip` by downloading the `.whl` file, or through `pipx` using the URL directly (recommended). For example, if you need Hugo 0.122.0, you can run `pipx install "https://github.com/agriyakhetarpal/hugo-python-distributions/releases/download/v0.122.0/hugo-0.122.0-cp311-cp311-win_amd64.whl"` to download and install the wheel for Hugo 0.122.0 on Windows for Python 3.11.
## Documentation
The documentation for this project is available at [https://agriyakhetarpal.github.io/hugo-python-distributions/](https://agriyakhetarpal.github.io/hugo-python-distributions/)
### Background
Binaries for the Hugo static site generator are available for download from the [Hugo releases page](https://github.com/gohugoio/hugo/releases). 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](https://python-poetry.org/) or [PDM](https://pdm.fming.dev/) to manage your Python dependencies or a tool such as [pipx](https://pipxproject.github.io/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](#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](#building-from-source) section or consider using the [official Hugo binaries](https://github.com/gohugoio/hugo/releases) 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](https://gohugo.io/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](LICENSE). Hugo is available under Apache 2.0 (see [the Hugo license](LICENSE-hugo.txt)) as well.
## Security
Please refer to the [Security policy](SECURITY.md) 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](CODE_OF_CONDUCT.md) for more information that applies to all interactions in this repository and its associated spaces. It is reliant on the [Contributor Covenant](https://www.contributor-covenant.org/) 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](https://discourse.gohugo.io/t/requesting-help/9132). For requesting help for `hugo-python-distributions`, please feel free to [open an issue](https://github.com/agriyakhetarpal/hugo-python-distributions/issues/new) in this repository.
## Inspirations for this project, and similar projects
### Binaries
- The official [Hugo](https://gohugo.io/) project, which is the source of the binaries provided by this project.
### Naming
- The [`cmake-python-distributions`](https://github.com/scikit-build/cmake-python-distributions) project by the [scikit-build](https://scikit-build.org/) 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`](pypi.org/project/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)](https://github.com/jmooring/hvm) 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`](https://github.com/dominique-mueller/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](https://github.com/conda-forge/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`](https://github.com/ziglang/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`](https://pypi.org/project/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`](https://github.com/Bing-su/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](https://gohugo.io/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`.