Agentic SWMM Workflow: automation for Hermes Agent

Verification-first stormwater modelling framework with EPA SWMM, QGIS, Skills and MCP, usable from Hermes

What Agentic SWMM Workflow does

Agentic SWMM Workflow is an open-source, verification-first framework for reproducible stormwater modelling with EPA SWMM. It ties together QGIS preprocessing, model generation from SWMMCanada inside Canada and SWMManywhere-based synthesis elsewhere, deterministic SWMM runs, QA checks, provenance tracking, calibration and climate-scenario support, and modelling memory, while keeping human modellers in control.

It ships with its own runtime, aiswmm, which accepts a modelling goal in natural language while model files, runs, plots, provenance records and audit notes stay visible as artifacts. The repository's MCP servers and Skills can also be used with other agent runtimes, including Codex, Claude, OpenClaw and Hermes. An aiswmm setup wizard offers ten provider routes with a local fallback chain. The method is described in a 2026 paper in AI for Engineering (MDPI), and the README marks the project pre-1.0, with v0.9.4 as the stable release.

Key features

aiswmm runtime that takes modelling goals in natural language
QGIS preprocessing and EPA SWMM execution with QA checks
Provenance tracking and audit notes for each run
Calibration, uncertainty and climate-scenario support
Modular Skills and MCP servers reusable from Codex, Claude, OpenClaw and Hermes
Setup wizard with ten LLM provider routes and a local fallback chain

When to use it

Build, run and audit a SWMM stormwater model from a one-sentence request
Reproduce a published modelling run offline from the committed case folders
Drive the Skills and MCP tools from Hermes instead of the built-in runtime

Who it is for: Stormwater and urban hydrology modellers who want auditable, agent-assisted SWMM workflows.

How it fits with Hermes Agent

A domain-specific project whose MCP servers and Skills the README says can be used with Hermes among other agent runtimes. The repository carries a hermes-skill topic.

How to install Agentic SWMM Workflow

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pip install aiswmm==0.9.4

Note: The README marks the project pre-1.0, with v0.9.4 as the current stable release.

FAQ

What is Agentic SWMM Workflow?

Agentic SWMM Workflow is an open-source framework for reproducible stormwater modelling with EPA SWMM. It combines QGIS preprocessing, deterministic model runs, QA checks, provenance tracking and agent-guided orchestration.

Does Agentic SWMM Workflow work with Hermes Agent?

The README says the repository's MCP servers and Skills can be used with other agent runtimes, including Hermes, Codex, Claude and OpenClaw. It also provides its own built-in runtime, aiswmm.

How do I install Agentic SWMM Workflow?

Install the aiswmm Python package with pip install aiswmm==0.9.4, then run the aiswmm setup wizard to choose an LLM provider route. One-line macOS, Linux and Windows installers and a Docker path are also documented.