Home
This is a no-dependency micro helper for developers of binary addons for Node. It is literally two small one-file utilities integrated with GitHub releases. The project solves two problems:
-
save-to-github-cache saves a binary artifact to a Github release according to the platform, architecture, and Node ABI.
- Designed to use with GitHub actions.
- Can be used to build and save locally.
-
install-from-cache retrieves a previously saved artifact, tests if it works properly, and rebuilds a project from sources in the case of failure.
- Supports an optional HTTP/HTTPS/SOCKS proxy for corporate / enterprise environments.
In general, it can save your users from a long recompilation and, in some cases, even save them from installing build tools. By using GitHub facilities (Releases and Actions) the whole process of publishing and subsequent installations are secure, transparent, painless, inexpensive, or even free for public repositories.
The motivation for this project can be found in Why???
We support all currently active Node versions. As of writing (April 2026) these are 20, 22, 24 (LTS) and 25 (current). The package declares engines.node": ">=18" since 1.5.0; older Node will refuse to install (or emit an EBADENGINE warning).