lythka/hao-patcher

Project overview

hao-patcher assembles installable disk images of macOS 27 (Golden Gate) for Intel x86_64 Macs that Apple no longer supports. The current build targets macOS 27.2.1 (26B131). Development and testing focus on a 2012 13-inch MacBook Pro (MacBookPro9,2, Ivy Bridge with Intel HD 4000); other Intel Macs are untested.

The image is layered rather than taken directly from one source: Golden Gate System and Data, Intel kernel extensions and boot files still shipped with macOS 26 Tahoe, legacy hardware support from OpenCore Legacy Patcher, compatibility patches, and hao-runtime, which runs ARM-only programs on the Intel CPU at roughly one-half to one-third native speed. A notable part of the project is accelerated Metal on the HD 4000, including repaired shader libraries for Maps 3D buildings and added argument-buffer and ASTC texture support for Weather. Sample results are in the gallery.

Quick start

The build host must be an Apple silicon Mac with Xcode command-line tools, Python 3.14, and an arm64 macOS virtual machine for disk operations. You also need to supply the macOS 27.2.1 IPSW, the Tahoe 25G342 installer and Kernel Debug Kit, OCLP support files, and a hao-runtime payload; follow Build inputs to prepare them.

git clone https://github.com/lythka/hao-patcher.git
cd hao-patcher
python3.14 -I tools/hao/hao build-image /path/to/new-image-repository --model MacBookPro9,2 --dry-run
python3.14 -I tools/hao/hao build-image /path/to/new-image-repository --model MacBookPro9,2

The first command prints the build plan, and the second performs the build. The building guide covers inputs, build steps, and QEMU testing; there is no end-user installer yet. The hao command in tools/hao is the starting point, and the planned path is toward a USB installer built on any Mac without Apple silicon or a VM.

Constraints and risks

• Dedicated test machine only. Installing an image overwrites the entire target disk, so use a Mac whose contents you can lose.
• Security is weakened by design. AMFI is off, SIP is lowered, authenticated root is off (csr-active-config 0x803), Secure Boot is disabled, System programs are ad hoc re-signed, and OpenCore loads third-party kexts.
• Runtime changes are hard to undo. hao-runtime modifies System files in place and has no uninstaller; its binary translation is experimental and can crash programs or damage data. See its Read first.
• Recovery requires planning. Hold Option at startup to boot another disk or Internet Recovery (Command-Option-R), reset NVRAM (Command-Option-P-R), then erase and reinstall a supported macOS or restore a backup.
• Inputs are not bundled. Apple's files must be supplied by the user. Original code is MIT-licensed, while third-party and Apple components keep their own terms as listed in NOTICE.md.

HotRepo's take

On 2026-11-14 the project entered HotRepo's new-project list for Python, with 109 stars and 10 forks reported and 7 stars gained in a roughly one-hour window. That is a single short-window observation rather than a trend. The technical scope is unusually specific: a working desktop, graphics acceleration, Wi-Fi, and hardware video decoding are documented for one 2012 MacBookPro9,2, while the build process still depends on an Apple silicon host and a dedicated VM. Readers should treat the project as an experimental research build, not a general-purpose Intel Mac installer.