Stela README

The project's README from github.com/tylertms/Stela. As one markdown file: README.md.


Stela

A translation-based Apple Silicon layer for x86-64 PCs. It is a UEFI boot program with an arm64-to-x86-64 translator, a Metal driver for NVIDIA GPUs and a model of Apple silicon hardware. Stela currently presents itself as an M2 Mac mini.

[!WARNING] Stela is still in development. It is slow and still may not boot on supported hardware. Fixes are on the way, please submit a GitHub Issue with your boot logs if you encounter an error!

Translator

An ahead-of-time and just-in-time compiler translates arm64e code to x86-64. It covers more than 3,000 AArch64 instruction encodings, maps guest registers to host registers and caches translated code.

NVIDIA driver

The Metal driver compiles AIR, Metal's shader IR, directly to NIR, Mesa's IR, and supports the Metal3 and Apple7 GPU families.

Hardware requirements

Part Requirement
CPU Intel or AMD x86-64-v2 (Intel Nehalem, AMD Bulldozer or newer). AVX2 and AVX-512 are used when present.
Memory 8 GB or more.
Firmware 64-bit UEFI with Secure Boot off.
GPU NVIDIA GeForce GTX 16 or RTX 20, 30, 40 or 50 series.
Disk NVMe, or SATA in AHCI mode. 60 GB or more for macOS: a GPT partition or a whole disk to erase.
USB stick 8 GB for the Online installer, 32 GB for the Offline installer.
Ethernet Intel I225, I226, I210, I211, I350, 82574L, 82575, 82576, 82579, 82580, I217, I218, I219.
Realtek RTL8111, RTL8168, RTL8169, RTL8411, RTL8125, RTL8126, Killer E2600, E3000.
Broadcom BCM5720, BCM5761, BCM5762.
Aquantia AQC100, AQC107, AQC108, AQC109, AQC111, AQC112, AQC113, AQC114, AQC115C, AQC116C.
Qualcomm Atheros AR8131, AR8132, AR8151, AR8152, AR8161, AR8162, AR8171, AR8172, Killer E2200, E2400, E2500.
USB: Realtek RTL8152, RTL8153, RTL8156, ASIX AX88179, AX88178A, AX88772, CDC ECM and NCM.
Wi-Fi None currently supported.
Bluetooth None currently supported.
Audio None currently supported.
USB xHCI (USB 3) and EHCI controllers, hubs, USB disks.
Input USB keyboards and mice. PS/2 keyboards, mice and Synaptics or Elantech touchpads.

Install

  1. Download stela from the releases page.
  2. Run sudo ./stela (Linux, macOS) or double-click stela.exe (Windows).
  3. Choose the USB stick and the installer, then confirm. This erases the USB stick.
  4. Boot the PC from the USB stick.

Update

Download the new stela, plug the USB stick in and run:

sudo ./stela update

On Windows, open Terminal with Run as administrator and run:

.\stela.exe update

Logs

If Stela does not work, plug the USB stick into the computer that made it and save the boot log. Include log.txt in your GitHub Issue.

sudo ./stela log --output log.txt

On Windows, open Terminal with Run as administrator and run:

.\stela.exe log --output log.txt

Build

You need Rust, git, Python 3.10 or newer, and LLVM 21, 22 or 23 with Clang, LLD and libclang. On macOS, Xcode's Apple clang 21 or newer also works.

git clone https://github.com/tylertms/Stela
cd Stela
cargo xtask dist

This writes target/release/stela. The first build fetches and compiles Linux, Mesa and LLVM sources and takes a long time.

Stela contains no Apple software. You are responsible for following Apple's software license agreement and terms of use.

Stela's code is GPL-2.0-or-later. See LICENSE and NOTICE.

Community

Discord Server

Stela (tylertms/Stela)

Searching Database…

What is this?Stela is a general purpose layer that lets Apple Silicon macOS run on regular x86-64 PCs. Setup writes a UEFI boot program to a USB stick, and you boot the PC from it.
Is it a regular app I install on my system?No, it is a bootable environment rather than a normal app. The stela setup tool writes it to a USB stick, and the PC boots from that stick into an arm64-to-x86-64 translator, a Metal driver for NVIDIA GPUs and a model of Apple silicon hardware.
How do I get it running?Download stela from the releases page and run sudo ./stela setup on Linux or macOS, or double-click stela.exe on Windows. Then choose the USB stick, the macOS version and the Mac model (it currently models the Mac mini M2 and runs macOS 27), confirm, and boot the PC from the stick. Setup erases the USB stick.
What do I need before I start?An x86-64-v2 CPU (about 2011 or newer), UEFI with Secure Boot turned off, 8 GB of RAM, an NVIDIA GTX 16 or RTX 20 series GPU or newer, a USB stick of 8 GB or more, an empty GPT partition of at least 60 GB, and network access during install because it downloads macOS.
Does it work well yet?Not really. The README warns that the chances of booting are low right now, and that macOS and most apps start but run slowly. Major hardware support and fixes are still on the way.
Does it need Apple hardware or can it run on ordinary PCs?It targets ordinary PCs. The translator runs on any x86-64-v2 CPU from Intel or AMD, so no Apple hardware is needed.
Can I use it without internet?Network access is needed during install to download macOS. The README does not say whether it works offline after that.
Is it free, and does it include macOS?The code is GPL-2.0-or-later and free to use. Stela contains no Apple software, so macOS is downloaded during install, and you are responsible for following Apple's license terms.
Which graphics cards work?The README only lists NVIDIA. The Metal driver supports GTX 16 and RTX 20 series GPUs and newer, compiles Metal's AIR shader IR to Mesa's NIR, and supports the Metal3 and Apple7 GPU families.
Will setup wipe my PC's hard drive?Setup erases only the USB stick you choose. The install itself needs an empty GPT partition of at least 60 GB on the PC.
How does the translation work?An ahead-of-time and just-in-time compiler translates arm64e code to x86-64. It covers more than 3,000 AArch64 instruction encodings, maps guest registers to host registers and caches translated code.
Can I update a USB stick made with an older version?Yes. Download the new stela, plug in the stick and run sudo ./stela setup update stela on Linux or macOS, or stela.exe setup update stela on Windows.
Creator
tylertms
Size
436 MB
Stars
3K
Age
1mo
Commits · 90 Days