Agents, Web App and Desktop#
PyHydroGeophysX includes a multi-agent system for natural-language hydrogeophysical workflows, plus a Qt desktop studio for hands-on interactive work. Start with the hosted app or quick start guide; the architecture page is contributor documentation. The agent stack includes dedicated support for SRT, FDEM, and joint ERT+SRT inversion orchestration.
Open Agent Web App
Launch guidance, required inputs, and direct app link.
Desktop Studio
Download the Qt desktop app (Windows / macOS) or run it from source.
Agent Quick Start
Configure providers and run your first agent workflow.
Contents
- Agent Web App
- Desktop Studio (Qt)
- Studio at a Glance
- Download the Desktop App
- Install and Run from Source
- Start Without a Terminal
- Your First Studio Run: ERT Inversion
- Time-Lapse ERT
- Module-by-Module Workflows
- Using AQUAH Chat Safely
- Letting AQUAH See a Result
- Saving, Exporting, and Reopening Work
- Modules
- How the Streamlit / Qt Bridge Works
- Remote Servers and Download Mode
- Persistence and Troubleshooting
- Building the Bundles Yourself
- Quick Start Guide
- Common Workflow Patterns
- Agent Reference
- Troubleshooting
- Data File Not Found
- API Key Missing or Invalid
- Wrong ERT Instrument Declared
- pyGIMLi or SimPEG Import Fails
- Mesh Generation Fails
- Inversion Diverges
- Streamlit Upload Size Exceeded
- Joint ERT+SRT Geometry Mismatch
- LLM Rate Limit or Quota Error
- Resuming a Failed or Interrupted Workflow
- 3D Mesh Generation Fails (gmsh not found)
- 3D Electrode View is Blank
- Quality Loop Never Reaches Threshold
- Ambiguous Natural-Language Request
- System Overview
- System Architecture