search

Kyle-Ye / XcodeLLMEligible

MIT License
1.11k stars 66 forks source link

readme

English | 简体中文

Darwin Eligibility Override

This project aims to achieve permanent use of Xcode LLM/Apple Intelligence on any Mac without disabling System Integrity Protection (SIP) or only disabling it once.

[!NOTE] Xcode LLM is only supported on macOS 15.0+

Apple Intelligence is only supported on macOS 15.1+

Screenshot

Notes

this project is for learning and research purposes only.

If you choose to use this project, you do so at your own risk and are responsible for compliance with any applicable laws.

The author of this project is not responsible for any consequences that may arise from your use of this project.

Usage

Method 1: util tool (Recommended)

Need one time SIP disable + "amfi_get_out_of_my_way=1" set boot-args in during the script.

[!TIP] If you have issue on how to disable SIP or set boot-args, see Manual Execution section for more detail.

# Force XcodeLLM to be eligiable
curl -L https://raw.githubusercontent.com/Kyle-Ye/XcodeLLMEligible/release/0.2/scripts/override.sh | bash -s -- install util xcodellm
# Force Apple Intelligence to be eligiable
curl -L https://raw.githubusercontent.com/Kyle-Ye/XcodeLLMEligible/release/0.2/scripts/override.sh | bash -s -- install util greymatter

Method 2: override file

Do not require disable SIP at all.

# Override XcodeLLM only
curl -L https://raw.githubusercontent.com/Kyle-Ye/XcodeLLMEligible/release/0.2/scripts/override.sh | bash -s -- install override xcodellm
# Override Apple Intelligence only
curl -L https://raw.githubusercontent.com/Kyle-Ye/XcodeLLMEligible/release/0.2/scripts/override.sh | bash -s -- install override greymatter

[!NOTE] The override file method is mutually exclusive.

This repository only provides separate override files for Xcode LLM and Apple Intelligence.

If you want to override multi key, please use util tool method and export the override file for your future use.

Uninstall

Method 1: util tool

# For XcodeLLM:
curl -L https://raw.githubusercontent.com/Kyle-Ye/XcodeLLMEligible/release/0.2/scripts/override.sh | bash -s -- uninstall util xcodellm
# For Apple Intelligence
curl -L https://raw.githubusercontent.com/Kyle-Ye/XcodeLLMEligible/release/0.2/scripts/override.sh | bash -s -- uninstall util greymatter

Method 2: override file

# For XcodeLLM:
curl -L https://raw.githubusercontent.com/Kyle-Ye/XcodeLLMEligible/release/0.2/scripts/override.sh | bash -s -- uninstall override xcodellm
# For Apple Intelligence
curl -L https://raw.githubusercontent.com/Kyle-Ye/XcodeLLMEligible/release/0.2/scripts/override.sh | bash -s -- uninstall override greymatter

Manual Execution

Method 1: util tool (Recommended)

  1. Disable SIP in recovery mode with csrutil disable
  2. Add boot argument by sudo nvram boot-args="amfi_get_out_of_my_way=1" and reboot
  3. Download eligibility_util from the release page and execute the following command
# For XcodeLLM:
./eligibility_util forceDomainAnswer --domain-name OS_ELIGIBILITY_DOMAIN_XCODE_LLM --answer 4
# For Apple Intelligence (macOS 15.1+ required)
./eligibility_util forceDomainAnswer --domain-name OS_ELIGIBILITY_DOMAIN_GREYMATTER --answer 4
# For clean Up as part of Apple Intelligence feature (macOS 15.1 Beta 3+ required)
./eligibility_util forceDomainAnswer --domain-name OS_ELIGIBILITY_DOMAIN_STRONTIUM --answer 4
  1. Enable SIP in recovery mode with csrutil enable and reboot.
  2. Remove boot argument by sudo nvram -d boot-args

Read Disabling and Enabling System Integrity Protection if you are unfamiliar with SIP operation.

You can only set boot-args in recovery mode or normal mode with SIP disabled.

After setting boot-args, remember to reboot to make the change take effect.

[!TIP]

For more technical detail, see Kyle-Ye/eligibility

Method 2: override file

No SIP disabled needed in total.

  1. Download the corresponding *.eligibility_overrides.data file from the release page and rename it to eligibility_overrides.data

For Xcode LLM, download xcodellm.eligibility_overrides.data

For Apple Intelligence, download greymatter.eligibility_overrides.data

  1. Find the correct container uuid for eligibilityd under /private/var/root/Library/Daemon\ Containers

List all container uuid by the following command:

sudo ls /private/var/root/Library/Daemon\ Containers
  1. Move downloaded file in the first step to the Data/Library/Caches/NeverRestore/ folder of the corresponding Deamon container. If you are not sure which one is the correct container directory for eligibilityd, you can try it one by one or add the downloaded files to all Deamon containers.
sudo mkdir /private/var/root/Library/Daemon\ Containers/<UUID>/Data/Library/Caches/NeverRestore
sudo cp eligibility_overrides.data /private/var/root/Library/Daemon\ Containers/<UUID>/Data/Library/Caches/NeverRestore/
  1. Relaunch the eligibilityd service
sudo pkill -9 eligibilityd
sudo launchctl kickstart -k system/com.apple.eligibilityd

Trouble Shooting

[!TIP] The difference of eligibility_util and eligibility_util_sip is that the former is for SIP disabled environment and the latter is for SIP enabled environment.

Issue of Method 1: util tool

curl -L https://raw.githubusercontent.com/Kyle-Ye/XcodeLLMEligible/release/0.2/scripts/override.sh | bash -s -- doctor

Issue of Method 2: override file

If you are unable to access the Daemon Container related folders, please check if the terminal app you are using has full disk access permission.

Path: Settings.app > Security & Privacy > Full Disk Access -> Add your terminal app to the list and enable it.

Other Xcode LLM related issue

  1. Confirom the override is working and you have the correct answer.
./eligibility_util_sip getDomainAnswer --domain-name OS_ELIGIBILITY_DOMAIN_XCODE_LLM
  1. Reenable SIP and then open Xcode to download Model.

See detail for #4

Other Apple Intelligence related issue

[!IMPORTANT] Suggestions:

  1. Log in with a US Apple ID
  2. Set Region to United States and English as the primary language
  3. Set English (United States) as your Siri language
  1. Confirom the override is working and you have the correct answer.
./eligibility_util_sip getDomainAnswer --domain-name OS_ELIGIBILITY_DOMAIN_GREYMATTER
  1. Go to Setting.app and choose "Apple Intelligence & Siri", click "Join Apple Intelligence Waitlist" button.

Step2

  1. You'll see "Joined Waitlist" label and wait for a while.

Step3

  1. You'll see "Preparing" label and wait for a while.

Step4

  1. You'll receive "Apple Intelligence is Here" notification.

Step5

  1. You can now turn on Apple Intelligence to use it.

Step6

Related links

Star History

Star History Chart

License

MIT. See LICENSE file.