Who it is forA user who wants Haros as a normal app icon instead of running it from a source checkout, or who needs a build for a machine without an official installer.
The problemAn installer may not exist for your platform, and running from source each time is slow to repeat.
The outcomeA packaged Haros app for your platform: a local .app on macOS, an x64 NSIS installer on Windows, or an x64 AppImage on Linux.
What you need first
- Bun 1.3.9+ within Bun 1.x (the repo pins Bun 1.3.12)
- Node.js 24.13.1+ within Node 24
- Git
- Each CLI-based Harness installed and authenticated on your machine, or a model service and its credentials added in Settings → Model services for Pi or another API Engine
Steps
- Run
git clone https://github.com/piai-lab/Haros.git, thencd Haros, thenbun install --frozen-lockfile. - On macOS, run
bun run dist:desktop:local-app; on Windows, runbun run dist:desktop:win; on Linux, runbun run dist:desktop:linux. - On Apple Silicon, open the app with
open apps/desktop/.electron-runtime/local-app/arm64/mac-arm64/Haros.app; on Intel Macs, useapps/desktop/.electron-runtime/local-app/x64/mac/Haros.app. - Quit Haros before rebuilding, and leave any explicit
--output-dirempty.
Prompt for your agent
In the piai-lab/Haros repo, run the packaging command for <platform> from the README after `bun install --frozen-lockfile`. Report the path of the generated app or installer. Verify that the output file exists at that path before reporting success.
Caveat. Local builds are unsigned and macOS builds are not notarized, and a successful build on one OS does not validate the others.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for piai-lab/Haros and "Package a standalone Haros app for your platform"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer