Issue Station
Sign In
Tools hereToolbox

pytorch - ✅(Solved) Fix Docs: Standardize macOS naming and clarify Apple Silicon dependency note in from-source install [1 pull requests, 1 comments, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
pytorch/pytorch#176907•Fetched 2026-04-08 00:23:58
View on GitHub
Comments
1
Participants
1
Timeline
45
Reactions
0
Author
Mukund103Mukund103
Participants
Mukund103Mukund103
Timeline (top)
mentioned ×15subscribed ×15labeled ×5referenced ×5

Fix Action

Fixed

PR fix notes

PR #176919: docs: unify macOS spelling

Description (problem / solution / changelog)

Fixes #176907

  • Standardize MacOS to macOS
  • Delete section about Intel Macs
  • Update MPS min supported macOS versions to 14.0

Changed files

  • README.md (modified, +0/-9)
  • RELEASE.md (modified, +2/-2)
  • aten/src/ATen/mps/EmptyTensor.cpp (modified, +1/-1)
  • docs/source/notes/mps.rst (modified, +2/-2)
RAW_BUFFERClick to expand / collapse

📚 The doc issue

There is inconsistent macOS naming in docs ("MacOS" vs "macOS"), and the from-source dependency note for macOS is unclear for Apple Silicon users.

In README.md (From Source -> Install Dependencies), the macOS section says: "Add this package on intel x86 processor machines only" with pip install mkl-static mkl-include, but it does not explicitly tell Apple Silicon (arm64, e.g., M1/M2/M3) users to skip it. This can confuse new contributors.

Affected locations:

  • README.md (macOS dependency section)
  • docs/source/notes/mps.rst (uses "MacOS" wording)

Suggest a potential alternative/fix

  • Standardize "MacOS" -> "macOS" in relevant docs.
  • In README macOS dependency section, make the guidance explicit:
    • Intel x86_64 macOS only: pip install mkl-static mkl-include
    • Apple Silicon (arm64): skip that command

cc @malfet @seemethere @svekars @sekyondaMeta @AlannaBurke

extent analysis

Fix Plan

Standardize macOS naming in docs

  • Update README.md and docs/source/notes/mps.rst to use consistent "macOS" naming.

Explicit guidance for macOS dependencies

  • In README.md, add a note for Apple Silicon users to skip the dependency installation:
### macOS

* Intel x86_64 macOS only: `pip install mkl-static mkl-include`
* Apple Silicon (arm64): **Skip this command**
  • Update docs/source/notes/mps.rst to use the correct "macOS" spelling.

Example code snippet

# README.md
### macOS

* Intel x86_64 macOS only: `pip install mkl-static mkl-include`
* Apple Silicon (arm64): **Skip this command**
# docs/source/notes/mps.rst
.. note::
    For macOS users, please note that the dependency installation is only required for Intel x86_64 systems.
    Apple Silicon (arm64) users can skip this step.

Verification

  • Review README.md and docs/source/notes/mps.rst to ensure the changes are applied correctly.
  • Verify that the documentation is consistent and clear for both Intel x86_64 and Apple Silicon users.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#ssr#installation#tensor shape#autograd error#conversation history#tool integration#LLM response#prompt template#agent execution

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

pytorch - ✅(Solved) Fix Docs: Standardize macOS naming and clarify Apple Silicon dependency note in from-source install [1 pull requests, 1 comments, 1 participants]