# Stela (tylertms/Stela)

> 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.

- GitHub: https://github.com/tylertms/Stela
- GitHub.Locker page: https://github.locker/tylertms/Stela
- Stars: 3K
- Language: Rust
- License: GPL-2.0
- Last push: 2026-11-17

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**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.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/tylertms/Stela/blob/main/README.md

<h1 align="center">
  <img src="assets/stela-icon.png" alt="" width="96"><br>
  Stela
</h1>

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.<br>Realtek RTL8111, RTL8168, RTL8169, RTL8411, RTL8125, RTL8126, Killer E2600, E3000.<br>Broadcom BCM5720, BCM5761, BCM5762.<br>Aquantia AQC100, AQC107, AQC108, AQC109, AQC111, AQC112, AQC113, AQC114, AQC115C, AQC116C.<br>Qualcomm Atheros AR8131, AR8132, AR8151, AR8152, AR8161, AR8162, AR8171, AR8172, Killer E2200, E2400, E2500.<br>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](https://github.com/tylertms/Stela/releases).
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:

```sh
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 any computer with `stela` and
save the boot log. Include `log.txt` in your GitHub Issue. Save it before you
start Stela again many times: the log keeps the start of each of the last
eight boots, but only the latest part of a long run.

```sh
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](https://rustup.rs), 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.

```sh
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.

## Legal

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](LICENSE) and [NOTICE](NOTICE).

## Community

[Discord Server](https://discord.gg/aSkwrJEMYc)

