diff --git a/.github/workflows/backend.yml b/.github/workflows/backend.yml index 13e67c6fe..d4bb0bf59 100644 --- a/.github/workflows/backend.yml +++ b/.github/workflows/backend.yml @@ -355,7 +355,7 @@ jobs: with: backend: ${{ matrix.backend }} build-type: ${{ matrix.build-type }} - go-version: "1.25.x" + go-version: "1.27.x" tag-suffix: ${{ matrix.tag-suffix }} lang: ${{ matrix.lang || 'python' }} use-pip: ${{ matrix.backend == 'diffusers' }} diff --git a/.github/workflows/backend_build_darwin.yml b/.github/workflows/backend_build_darwin.yml index 6b8b2a89b..19952a5ef 100644 --- a/.github/workflows/backend_build_darwin.yml +++ b/.github/workflows/backend_build_darwin.yml @@ -22,7 +22,8 @@ on: type: string go-version: description: 'Go version to use' - default: '1.24.x' + # Go 1.27 stamps pure-Go hosts with SDK metadata that supports modern Metal APIs. + default: '1.27.x' type: string tag-suffix: description: 'Tag suffix for the built image' diff --git a/.github/workflows/backend_pr.yml b/.github/workflows/backend_pr.yml index c13c444c4..2626f87e8 100644 --- a/.github/workflows/backend_pr.yml +++ b/.github/workflows/backend_pr.yml @@ -281,7 +281,7 @@ jobs: with: backend: ${{ matrix.backend }} build-type: ${{ matrix.build-type }} - go-version: "1.25.x" + go-version: "1.27.x" tag-suffix: ${{ matrix.tag-suffix }} lang: ${{ matrix.lang || 'python' }} use-pip: ${{ matrix.backend == 'diffusers' }} diff --git a/docs/content/getting-started/build.md b/docs/content/getting-started/build.md index 77884a412..42e64928d 100644 --- a/docs/content/getting-started/build.md +++ b/docs/content/getting-started/build.md @@ -30,6 +30,10 @@ To install the dependencies follow the instructions below: {{< tabs >}} {{% tab title="Apple" %}} +To build pure-Go backend hosts that load Metal libraries, use Go 1.27 or later on macOS 13 or later. +Go 1.27 records macOS SDK 26.2 in internally linked executables, which enables modern Metal APIs in these hosts. +Rebuild the affected backend after upgrading Go. Rebuilding only `local-ai` does not update installed backend executables. + Install `xcode` from the App Store ```bash