Download & Installation

Download Latest Release

Try it with Docker (Recommended)

For the most reproducible setup across machines, install Docker Desktop or Docker Engine, then run the following command to execute the acceptance benchmarks:

                    mkdir -p agentic-swmm-runs
docker run --rm -v "$PWD/agentic-swmm-runs:/app/runs" ghcr.io/zhonghao1995/agentic-swmm-workflow:v0.3.0 acceptance
                

Artifacts are written to agentic-swmm-runs.

One Command Options

The repository also includes one-command setup scripts for local installs. Review the script first, then run it if you are comfortable with what it does.

macOS / Linux local install

                        bash -c "$(curl -fsSL https://raw.githubusercontent.com/Zhonghao1995/agentic-swmm-workflow/main/scripts/bootstrap.sh)"
                    

Windows PowerShell local install

Run PowerShell as Administrator:

                        powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/Zhonghao1995/agentic-swmm-workflow/main/scripts/bootstrap.ps1'))"
                    

Codex / OpenClaw / Hermes Ready

Codex can serve as the primary local development runtime for this repository: it can inspect the checkout, run scripts, edit skills, generate audit records, update the local Obsidian vault, and review evidence before claims are accepted.

OpenClaw and Hermes remain compatible orchestration targets, especially for MCP-centered agent runs outside the Codex development environment.

For agent-orchestrated runs, preload the Agentic AI memory package and then use the top-level end-to-end skill:

                    agentic-ai/memory/
skills/swmm-end-to-end/SKILL.md
                