HakobuHakobu

Quick Start

Package your first Node.js app into a standalone executable in under 5 minutes.

Package Your First App

Create a simple app

Create a file called hello.js:

hello.js
console.log('Hello from Hakobu!');

Package it into an executable

Run Hakobu to produce a standalone binary. By default, it builds for your current platform:

npx @hakobu/hakobu hello.js

To target a specific platform and architecture, use the --target flag:

npx @hakobu/hakobu hello.js --target node24-linux-x64

Hakobu will download the appropriate patched Node.js base binary (cached in ~/.hakobu/cache/), bundle your code into the snapshot filesystem, and produce an executable.

Run the executable

The output binary has the same name as your entry file. Run it directly -- no Node.js required on the target machine:

./hello
# Hello from Hakobu!

On Windows, the output is hello.exe:

hello.exe
# Hello from Hakobu!

The first run may take a moment while Hakobu downloads the base binary for your target. Subsequent builds reuse the cached binary.

Specifying an Output Path

Use --output to control where the executable is written:

npx @hakobu/hakobu hello.js --output ./dist/hello

Packaging a Full Project

For real-world projects, point Hakobu at your package.json directory:

npx @hakobu/hakobu . --output ./dist/my-app

Hakobu reads the "main" or "bin" field from your package.json, resolves all dependencies, and packages everything into a single binary.

What's Next

On this page