Getting started
===============

Three ways in, depending on how you want to work. They run the same workflows.

.. grid:: 1 1 3 3
   :gutter: 3
   :class-container: phgx-cards

   .. grid-item-card:: Python
      :link: quickstart
      :link-type: doc

      Install the package and convert a hydrological state into a geophysical
      property in about ten minutes, with no field data and no optional
      engines.

      +++
      10-minute quickstart

   .. grid-item-card:: Desktop Studio
      :link: agents/desktop_studio
      :link-type: doc

      Download the interactive application for Windows or macOS, or run it from
      a source checkout.

      +++
      Download and run

   .. grid-item-card:: Guided install
      :link: agent_install
      :link-type: doc

      Watch the installation walkthrough and copy a prompt that asks an AI
      agent to check your environment, install the package and verify startup.

      +++
      Watch and copy the prompt

Then choose a direction
-----------------------

- :doc:`Workflows <tutorials/index>` if you are starting from your data: a
  hydrological model, a field survey, or repeated surveys.
- :doc:`Methods <methods/index>` if you already know which measurement you are
  working with.
- :doc:`Examples <examples/index>` for complete, downloadable scripts.

What the package is for
-----------------------

Information travels in both directions between a hydrological model and a
geophysical survey. A model state predicts what a survey should measure, and a
survey constrains what the model should hold.
:doc:`Connecting geophysical data and hydrological models
<tutorials/hydro_geophysical_interaction>` walks that connection end to end and
is the best single page to read before choosing a workflow.

.. toctree::
   :maxdepth: 1
   :hidden:

   installation
   quickstart
   Desktop Studio <agents/desktop_studio>
   agent_install