Nunchaku Installer
A simple command-line tool to easily install the Nunchaku Python library, working around the file size limit on PyPI.
Why this tool?
The Nunchaku library is distributed as .whl files that exceed the maximum size allowed by PyPI (over 100 MB). This installer automates the process of:
- Detecting your system configuration (OS, Python version, PyTorch version).
- Finding the corresponding Nunchaku version on GitHub releases.
- Downloading and installing the correct
.whlfile.
Installation
You can install nunchaku-installer via pip:
pip install nunchaku-installer
Usage
Installing the latest version of Nunchaku
The basic command automatically detects your system and installs the latest compatible version of Nunchaku.
nunchaku-installer install
Installing a specific version
You can specify an exact version by using its GitHub release tag.
nunchaku-installer install --version v0.3.1
Using uv as the installation backend
If you prefer to use uv (an ultra-fast installer), you can specify it with the --backend option.
# Make sure 'uv' is installed (pip install uv)
nunchaku-installer install --backend uv
Listing available versions
To see all the Nunchaku versions that you can install:
nunchaku-installer list-versions
Acknowledgements
This installer is a community-driven companion tool created to facilitate the installation of the main Nunchaku library. A big thank you to the entire nunchaku-tech team for their incredible work.
License
This project is licensed under the MIT License.
Metadata
Release files for nunchaku-installer 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| nunchaku_installer-0.1.0.tar.gz | 6.6 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nunchaku_installer-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 14.8 kB
Release files / nunchaku_installer-0.1.0.tar.gz
| Download URL | nunchaku_installer-0.1.0.tar.gz |
|---|---|
| Size | 6.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ad5681a34fa47d016359b75d0aa877d3113fdd106570649e705d3861ef28c920
|
|
BLAKE2b-256 checksum How to use checksums |
ad04c7fc8049a2a79d771e3b8178000015ddb78e7cf2d79fb342526ecb0cd50b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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 Jul 17, 2025.
Transparency logRelease files / nunchaku_installer-0.1.0-py3-none-any.whl
| Download URL | nunchaku_installer-0.1.0-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
932688d460b77697af916f47aceb61a6a0352c6dfd6bece36ccaef0afb101ed2
|
|
BLAKE2b-256 checksum How to use checksums |
61be16f02a97e08f47c07df4dc1f22f0da9424e068365b2d3962dcc3f342a098
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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 Jul 17, 2025.
Transparency logSecurity for nunchaku-installer 0.1.0
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for nunchaku_installer-0.1.0.tar.gz
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 Jul 17, 2025.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.