sysprog21

sysprog21 / elfuse

Public

Run Arm64/Linux ELF binaries on macOS Apple Silicon

arm64 darwin-kernel hypervisor-framework linux-compatibility linux-syscall
13
1
100% credibility
Found May 04, 2026 at 13 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
C
AI Summary

elfuse enables running aarch64 Linux ELF binaries natively on macOS Apple Silicon via Hypervisor.framework, emulating processes, threads, syscalls, and /proc for user-space compatibility.

How It Works

1
🖥️ Discover elfuse

You hear about a handy tool that lets you run Linux apps right on your Mac without extra hassle.

2
📥 Get elfuse ready

Download and prepare it with simple steps so it's all set up on your Apple Silicon Mac.

3
🔨 Build with one click

Hit a quick command and elfuse springs to life, ready for action.

4
🧪 Test it out

Try a sample Linux app like BusyBox and see it working perfectly on your Mac.

5
🏃 Run your app

Point elfuse to your own Linux ARM64 program and launch it seamlessly.

6
Need libraries?
✅
Static app

Your standalone program runs right away.

📁
Dynamic app

Connect the supporting files and go.

🎉 Linux on Mac magic!

Enjoy your Linux software running smoothly, with threads, debugging, and all, just like on Linux.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 13 to 13 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is elfuse?

elfuse runs Arm64 Linux ELF binaries natively on macOS Apple Silicon via Apple's Hypervisor.framework, answering "can arm64 run linux" without QEMU slowdowns or Docker overhead for docker run linux arm64. Written in C, it handles static and dynamic executables (use --sysroot for libs), guest threads, signals, /proc views, and GDB debugging right from your shell. Just build it and invoke: `./elfuse ./your-arm64-binary [args]`.

Why is it gaining traction?

It skips emulation for true hardware acceleration, beating QEMU on speed while emulating enough Linux user-space (fork, futexes, netlink) for real workloads. Built-in GDB RSP stub and syscall translation make it debuggable like native Linux, unlike container hacks. Niche appeal for run github actions locally or run github workflow locally on Mac.

Who should use this?

Apple Silicon devs testing Arm64 Linux tools, like BusyBox or CI binaries, without VMs. Suited for those running GitHub Actions from branch, manually triggering run github action manually, or porting arm64 apps. Skip if you need full kernel features.

Verdict

Promising for Mac users needing fast Arm64 Linux execution—grab it if run arm64 on x64 linux alternatives fail on Apple hardware. 1.0% credibility score and 13 stars signal early days, but solid docs, tests, and self-hosted QEMU validation suggest maturity beyond the numbers.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.