deploy: 10188d5

.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: b17df779cf5e1bcae6b7940371ca50ad
+config: 58c729919378167edc48746215a9ba2e
 tags: 645f666f9bcd5a90fca523b33c5a78b7

_sources/source/getting_started.rst.txt

@@ -95,6 +95,21 @@ You can also use the GitHub version of SQuADDS by changing Step 4 to:
    pip install -r requirements.txt
    pip install -e .
 
+Installing SQuADDS on Apple Silicon
+-----------------------------------
+
+`qiskit-metal` currently lacks full native support for Apple Silicon due to `PySide` compatibility issues (`a PR resolving this issue is still waiting for review <https://github.com/qiskit-community/qiskit-metal/pull/908>`_). Since SQuADDS is built on top of `qiskit-metal`, sadly it also doesn't support Apple Silicon natively . However, you can still run SQuADDS on Apple Silicon by emulating the `x86` architecture with Rosetta.
+
+1. **Create a new conda environment** configured to emulate `x86` with Python 3.10 or 3.11:
+
+   .. code-block:: bash
+
+      CONDA_SUBDIR=osx-64 conda create -n <env_name> python=3.11
+      conda activate <env_name>
+      conda config --env --set subdir osx-64
+
+2. **Install `qiskit-metal` and `SQuADDS`** as outlined above within this environment.
+
 .. admonition:: Questions?
 
    Please reach out to `shanto@usc.edu <mailto:shanto@usc.edu>`__ if you face any installation issues.

source/getting_started.html

@@ -668,6 +668,20 @@ <h2>Fresh Environment Installation<a class="headerlink" href="#fresh-environment
 pip<span class="w"> </span>install<span class="w"> </span>-e<span class="w"> </span>.
 </pre></div>
 </div>
+</section>
+<section id="installing-squadds-on-apple-silicon">
+<h2>Installing SQuADDS on Apple Silicon<a class="headerlink" href="#installing-squadds-on-apple-silicon" title="Link to this heading">#</a></h2>
+<p><cite>qiskit-metal</cite> currently lacks full native support for Apple Silicon due to <cite>PySide</cite> compatibility issues (<a class="reference external" href="https://github.com/qiskit-community/qiskit-metal/pull/908">a PR resolving this issue is still waiting for review</a>). Since SQuADDS is built on top of <cite>qiskit-metal</cite>, sadly it also doesn’t support Apple Silicon natively . However, you can still run SQuADDS on Apple Silicon by emulating the <cite>x86</cite> architecture with Rosetta.</p>
+<ol class="arabic">
+<li><p><strong>Create a new conda environment</strong> configured to emulate <cite>x86</cite> with Python 3.10 or 3.11:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CONDA_SUBDIR</span><span class="o">=</span>osx-64<span class="w"> </span>conda<span class="w"> </span>create<span class="w"> </span>-n<span class="w"> </span>&lt;env_name&gt;<span class="w"> </span><span class="nv">python</span><span class="o">=</span><span class="m">3</span>.11
+conda<span class="w"> </span>activate<span class="w"> </span>&lt;env_name&gt;
+conda<span class="w"> </span>config<span class="w"> </span>--env<span class="w"> </span>--set<span class="w"> </span>subdir<span class="w"> </span>osx-64
+</pre></div>
+</div>
+</li>
+<li><p><strong>Install `qiskit-metal` and `SQuADDS`</strong> as outlined above within this environment.</p></li>
+</ol>
 <div class="admonition-questions admonition">
 <p class="admonition-title">Questions?</p>
 <p>Please reach out to <a class="reference external" href="mailto:shanto&#37;&#52;&#48;usc&#46;edu">shanto<span>&#64;</span>usc<span>&#46;</span>edu</a> if you face any installation issues.</p>
@@ -799,6 +813,7 @@ <h2><code class="docutils literal notranslate"><span class="pre">.env</span></co
 <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#install-from-github">Install from GitHub</a></li>
 <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#install-using-docker">Install using Docker</a></li>
 <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#fresh-environment-installation">Fresh Environment Installation</a></li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#installing-squadds-on-apple-silicon">Installing SQuADDS on Apple Silicon</a></li>
 </ul>
 </li>
 <li class="toc-h1 nav-item toc-entry"><a class="reference internal nav-link" href="#faqs">FAQs</a><ul class="visible nav section-nav flex-column">