Install with an AI agent
========================

Use a coding assistant with terminal access to install the package, check
dependencies and verify a small example. Review its installation plan first.

Installation video
------------------

.. raw:: html

   <div class="setup-video">
     <iframe src="https://www.youtube-nocookie.com/embed/W9SpHMyN9Fc"
       title="Installing PyHydroGeophysX with an AI coding agent"
       loading="lazy" allow="fullscreen; picture-in-picture" allowfullscreen></iframe>
   </div>

`Watch on YouTube <https://www.youtube.com/watch?v=W9SpHMyN9Fc>`_ if the embedded
player does not load.

Copy this prompt
----------------

Paste this into Claude Code, Codex or another coding assistant. It matches the
README installation prompt and covers CPU, optional CUDA and Desktop Studio.

.. literalinclude:: _static/install-agent-prompt.txt
   :language: text

:download:`Download the prompt as text <_static/install-agent-prompt.txt>`.

Manual setup: :doc:`installation` and :doc:`agents/desktop_studio`.
For the separate in-app AQUAH assistant, see :doc:`agents/quick_start`.


What counts as a verified GPU installation?
---------------------------------------------

The agent must report runtime, single-survey and time-lapse checks separately,
using ``python -m PyHydroGeophysX.inversion.adtlert_diagnostics --report gpu-check.json``.
A green GPU indicator or successful single-survey run is insufficient evidence
for time-lapse. Preserve the diagnostic report, actual source path and environment
export. See :doc:`installation` for OpenMP failure handling. Installation does
not authorize changing inversion algorithms or suppressing runtime errors.