One-line runtime installer
Installs the aiswmm CLI runtime and prepares the local Agentic SWMM command
surface.
curl -fsSL https://aiswmm.com/install.sh | bash
Get started
Install Agentic SWMM
Pick the path that fits your work — a one-line installer for the full local runtime, the aiswmm Python package, or the pinned Docker image for reproducible runs. The current stable point release is v0.7.1.
Install
Start with the one-line installer for your operating system. Python and Docker are available for package-managed or containerized workflows. Every command below has a copy button.
One-line runtime installer
Runs the Windows bootstrap path for the same local aiswmm runtime.
irm https://aiswmm.com/install.ps1 | iex
Install the aiswmm package
Use this path when Python 3.10 or newer is already available.
pip install aiswmm
Pin the exact version for any work whose results you intend to cite:
pip install aiswmm==0.7.1
Preview builds need an explicit opt-in:
pip install --pre aiswmm
Reproducible container
Bundles the EPA SWMM solver and Python environment in a fixed container — the recommended path for reproducible or production runs.
docker pull ghcr.io/zhonghao1995/agentic-swmm-workflow:v0.7.1
Run the acceptance benchmarks, mounting a local directory for the artifacts:
mkdir -p agentic-swmm-runs docker run --rm -v "$PWD/agentic-swmm-runs:/app/runs" ghcr.io/zhonghao1995/agentic-swmm-workflow:v0.7.1 acceptance
After installation
Launch the interactive runtime and describe the SWMM task you want to run:
aiswmm
Configure a model provider and verify the install:
aiswmm setup --provider openai --model gpt-5.5-2026-04-23 aiswmm doctor
Aliases like gpt-5.5 also work, but a dated snapshot such as
gpt-5.5-2026-04-23 is recommended — aliases silently roll forward when OpenAI ships a
new snapshot, which breaks bit-for-bit reproducibility of past runs.
Keep API keys outside the conversation. Configure OPENAI_API_KEY during setup or in
your shell environment. Never paste an API key into the aiswmm conversation, and
rotate any key that is accidentally pasted into an agent prompt.
Review the installer first
The one-line installers pipe a remote script straight into your shell. To see what runs before it runs, fetch the script first — these commands download the installer without executing it:
Review the macOS / Linux installer script
curl -fsSL https://aiswmm.com/install.sh
Review the Windows PowerShell installer script
irm https://aiswmm.com/install.ps1
For a reproducible install, pin a release tag before running:
curl -fsSL https://aiswmm.com/install.sh | AISWMM_INSTALL_REF=v0.7.1 bash
Agent runtimes — Codex / Claude / OpenClaw / Hermes
Beyond its own aiswmm runtime, the Agentic SWMM workflow can be driven by external agent
runtimes — Codex, Claude Code, OpenClaw, or Hermes. The repository's MCP servers and Skills work
across these orchestration targets.
For an agent-orchestrated run, preload the agent/memory/ package and point the runtime
at the top-level entry skill skills/swmm-end-to-end/SKILL.md, which decides which
workflow path to take, which QA gates must pass, and when to stop rather than invent missing
inputs.
See the Codex runtime path and the OpenClaw execution path for the full tool-call sequence.
Releases and documentation
Browse the changelog, download release artifacts, or read the full installation and CLI guide.