Skip to content

Commit 11d4774

Browse files
docs: Add FAQ on backends support on Apple silicon Macs
* At the moment, TensorFlow does not have Apple silicon compatible wheels on PyPI. As an alternative, not that conda-forge has linux-64 and osx-arm64 compatible releases for all of pyhf's backends. - c.f. https://github.com/tensorflow/tensorflow/issues 57185
1 parent 29fb68e commit 11d4774

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

docs/faq.rst

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,25 @@ Use the :code:`--backend` option for :code:`pyhf cls` to specify a tensor backen
3030
The default backend is NumPy.
3131
For more information see :code:`pyhf cls --help`.
3232

33+
Why can't ``pip`` find compatible backends on PyPI for Apple silicon Macs?
34+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
35+
36+
Unfortunately, at this time |tensorflow Issue 57185|_ of ``pyhf``'s backends support
37+
wheels for Apple silicon Macs (``osx-arm64``).
38+
So if you are installing wheels from PyPI on an ``osx-arm64`` machine, you will
39+
only be able to use a subset of all the backends.
40+
41+
An alternative would be to create a |micromamba|_ environment and install the
42+
backends individually from `conda-forge <https://prefix.dev/channels/conda-forge/>`__
43+
as all the backends have conda-forge releases compatible with ``linux-64`` and
44+
``osx-arm64``.
45+
46+
.. |tensorflow Issue 57185| replace:: not all
47+
.. _`tensorflow Issue 57185`: https://github.com/tensorflow/tensorflow/issues/57185
48+
49+
.. |micromamba| replace:: ``micromamba``
50+
.. _`micromamba`: https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html
51+
3352
I installed an old ``pyhf`` release from PyPI, why am I getting an error from a dependency?
3453
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3554

0 commit comments

Comments
 (0)