Stela README

README проекта с github.com/tylertms/Stela. Одним файлом markdown: 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)

Ищем в базе…

Что это такое?Stela — это универсальный слой, который позволяет macOS на Apple Silicon работать на обычных ПК с процессорами x86-64. Установка записывает программу для загрузки UEFI на USB-флешку, и вы загружаете ПК с неё.
Это обычное приложение, которое ставится в систему?Нет, это загрузочная среда, а не обычное приложение. Утилита stela setup записывает её на USB-флешку, и ПК загружается с флешки в транслятор arm64 в x86-64, драйвер Metal для видеокарт NVIDIA и модель оборудования Apple silicon.
Как это запустить?Скачайте stela со страницы releases и выполните sudo ./stela setup в Linux или macOS либо дважды щёлкните stela.exe в Windows. Затем выберите USB-флешку, версию macOS и модель Mac (сейчас моделируется Mac mini M2, работает macOS 27), подтвердите и загрузите ПК с флешки. Установка стирает данные на USB-флешке.
Что нужно перед началом?Процессор с поддержкой x86-64-v2 (примерно 2011 года или новее), UEFI с выключенным Secure Boot, 8 ГБ оперативной памяти, видеокарта NVIDIA серии GTX 16 или RTX 20 либо новее, USB-флешка объёмом от 8 ГБ, пустой раздел GPT размером не менее 60 ГБ и доступ к сети во время установки, так как она скачивает macOS.
Уже хорошо работает?Не особо. В README предупреждается, что шансы на загрузку сейчас невелики, а macOS и большинство приложений запускаются, но работают медленно. Поддержка основного оборудования и исправления ещё в разработке.
Нужно ли для этого оборудование Apple или можно запустить на обычном ПК?Она рассчитана на обычные ПК. Транслятор работает на любом процессоре x86-64-v2 от Intel или AMD, поэтому оборудование Apple не нужно.
Можно ли использовать без интернета?Во время установки нужен доступ к сети, чтобы скачать macOS. В README не сказано, работает ли она офлайн после этого.
Это бесплатно и включает ли macOS?Код распространяется под лицензией GPL-2.0-or-later и доступен бесплатно. Stela не содержит программного обеспечения Apple, поэтому macOS скачивается во время установки, и вы сами отвечаете за соблюдение условий лицензии Apple.
Какие видеокарты работают?В README указаны только карты NVIDIA. Драйвер Metal поддерживает видеокарты серий GTX 16 и RTX 20 и новее, преобразует AIR shader IR из Metal в NIR из Mesa и работает с семействами GPU Metal3 и Apple7.
Установка сотрёт жёсткий диск моего ПК?Установка стирает только выбранную вами USB-флешку. Для самой установки на ПК нужен пустой раздел GPT размером не менее 60 ГБ.
Как работает трансляция?Компилятор с опережающей компиляцией (AOT) и с компиляцией на лету (JIT) переводит код arm64e в x86-64. Он охватывает более 3000 кодировок инструкций AArch64, сопоставляет регистры гостевой системы с регистрами хоста и кэширует переведённый код.
Можно ли обновить USB-флешку, созданную старой версией?Да. Скачайте новую версию stela, вставьте флешку и выполните sudo ./stela setup update stela в Linux или macOS либо stela.exe setup update stela в Windows.
Какие есть похожие проекты?Madeira, Henge, nv-uefi-unlocker, Snapintosh, vinix, Windows-GPU-UNLOCK, MacNativeGames, Bridgeplay
Автор
tylertms
Размер
436 MB
Звёзды
3K
Возраст
1 мес
Коммиты · 90 дней