Introduction

Hakobu is the modern Node.js packager — the successor to @yao-pkg/pkg. Package your app into a standalone cross-platform binary.

Hakobu is the modern Node.js packager -- the successor to @yao-pkg/pkg. It packages your Node.js applications into standalone executables that run on any machine, even without Node.js installed.

Why Hakobu?

Cross-platform builds -- Target Linux, macOS, and Windows from a single machine
ESM + CJS support -- Native ESM with "type": "module", CommonJS, and mixed ESM/CJS with createRequire() all work out of the box
Rolldown bundler built-in -- Optional --bundle mode for TypeScript and monorepo projects, powered by Rolldown
Snapshot filesystem -- Your source files, assets, and dependencies are embedded in a virtual filesystem inside the binary
V8 snapshots for instant startup -- Pre-initialized heap snapshots eliminate cold-start overhead
Native addon support -- .node files are detected and included automatically
Code signing -- Built-in macOS and Windows code signing for distribution-ready binaries

Quick Example

Package the current project for the host platform:

npx @hakobu/hakobu .

Or target a specific platform:

npx @hakobu/hakobu . --target node24-linux-x64 --output ./dist/my-app

The resulting binary is fully self-contained and ready to distribute.

Next Steps

Installation

Install Hakobu via npm, pnpm, yarn, or bun.

Quick Start

Package your first app into an executable in under 5 minutes.

Build Targets

Learn about target platforms and architectures.

Migration from pkg

Coming from @yao-pkg/pkg? See what changed.