Quick Start
Package your first Node.js app into a standalone executable in under 5 minutes.
Package Your First App
Package it into an executable
Run Hakobu to produce a standalone binary. By default, it builds for your current platform:
npx @hakobu/hakobu hello.jsTo target a specific platform and architecture, use the --target flag:
npx @hakobu/hakobu hello.js --target node24-linux-x64Hakobu 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/helloPackaging a Full Project
For real-world projects, point Hakobu at your package.json directory:
npx @hakobu/hakobu . --output ./dist/my-appHakobu reads the "main" or "bin" field from your package.json, resolves all dependencies, and packages everything into a single binary.