infra: Install Xcode/Metal developer tools for .metallib compilation #60

New issue

Closed

opened 2026-05-21 01:12:49 +02:00 by sleepy · 0 comments

sleepy commented

2026-05-21 01:12:49 +02:00

Owner

The metal and metallib command-line tools are required to compile .metal sources into .metallib at build time, but are not available on this machine.

Current Behavior

zig build creates an empty sleepy-llm.metallib (0 bytes)
Runtime fails with LibraryLoadFailed when trying to load the empty metallib

Required Tools

xcrun metal — compile .metal → .air
xcrun metallib — link .air → .metallib

Installation

Full Xcode from App Store or xcode-select --install (if it includes Metal tools)

Workaround

None — Metal kernels are required for GPU inference.

Verification

After installation:

xcrun -f metal  # should return path
xcrun -f metallib  # should return path
rm -rf zig-out .zig-cache
zig build --release=fast
ls -la zig-out/bin/sleepy-llm.metallib  # should be >0 bytes

The `metal` and `metallib` command-line tools are required to compile `.metal` sources into `.metallib` at build time, but are not available on this machine. ## Current Behavior - `zig build` creates an empty `sleepy-llm.metallib` (0 bytes) - Runtime fails with `LibraryLoadFailed` when trying to load the empty metallib ## Required Tools - `xcrun metal` — compile `.metal` → `.air` - `xcrun metallib` — link `.air` → `.metallib` ## Installation Full Xcode from App Store or `xcode-select --install` (if it includes Metal tools) ## Workaround None — Metal kernels are required for GPU inference. ## Verification After installation: ```bash xcrun -f metal # should return path xcrun -f metallib # should return path rm -rf zig-out .zig-cache zig build --release=fast ls -la zig-out/bin/sleepy-llm.metallib # should be >0 bytes ```

sleepy added the

infra

label

2026-05-21 01:13:03 +02:00

sleepy referenced this issue from a commit

2026-05-21 17:16:13 +02:00

fix(#60): runtime Metal shader compilation when metallib unavailable

sleepy referenced this issue from a pull request that will close it,

2026-05-21 17:16:34 +02:00

[infra] Runtime Metal shader compilation when metallib unavailable (#60) #61

sleepy referenced this issue from a commit

2026-05-21 17:16:58 +02:00