InterPSS Agentic Power System Simulation Agent for AC load flow, DC-based contingency analysis, and report generation, including NERC TPL-001-5 style. This repository ships agent-facing skills for OpenAI Codex Desktop and DeepSeek Harness (build and CLI details in Setup.md; DSH plugin in InstallDSHPlugin.md). The batch run canonical skill is [.agents/skills/ipss-sim/SKILL.md](.agents/skills/ipss-sim/SKILL.md). (see batch chat user guide for details):
It is also integrated into DeepSeek Harness as a DSH Plugin. You can run power system simulation in the traditional step-by-step way in a local sandbox (DSH plugin user guide):
The simulation results can be visualized in a one-line diagram:
Prerequisites: Java JDK 21, Maven (or the included mvnw wrapper).
Prompt Codex, Claude Code, or DeepSeek Harness to clone and build ipss-agent:
Install(Update) and setup ipss-agent from https://github.com/InterPSS-Project/ipss-agent
Depending on your network speed, it may take some time to download dependencies and build the CLI.
Build the Java CLI from the project root:
./mvnw -q clean packageThis produces target/ipss-agent-cmd-1.0.0-uber.jar. See Setup.md for the full layout, tests, and configuration.
Test the setup with a sample case directory:
init # for the first time installation
/ipss-sim data/ieee/Ieee118Bus/ "IEEE 118-Bus Test Case"
Install DeepSeek Harness (Desktop version is recommended). Prompt DeepSeek Harness to install InterPSS DSH plugin:
Install(update) InterPSS DSH plugin
Open the iPSS Agent folder as a workspace in DSH. You can then run the power system simulation workflow or chat following the DSH plugin user guide.
- InterPSS DSH Plugin user guide dsh_plugin_user_guide.md
- InterPSS One-Line Diagram user guide oneline_diagram_user_guide.md
- InterPSS Loadflow Adjustment user guide loadflow-adjustment-user-guide.md
- iPSS Agent Chat (Batch) user guide batch_chat_user_guide.md
| Topic | Document |
|---|---|
| Layout, build, JARs, agent skills | Setup.md |
IpssCmd (Java CLI) usage |
IpssCmd.md |
| Markdown report generator | GenReport.md |
| DeepSeek Harness DSH plugin | InstallDSHPlugin.md |
| DSH plugin package | interpss-persistent/README.md |
| InterPSS chat tools | docs/interpss-tools.md |
| Interactive HTML dashboards | [.agents/skills/nerc-report-html/SKILL.md](.agents/skills/nerc-report-html/SKILL.md) |
| NERC slide decks | [.agents/skills/nerc-report-slides/SKILL.md](.agents/skills/nerc-report-slides/SKILL.md) |
| Load a simulation case into the bridge | .agents/skills/ipss-case-load/SKILL.md |
| Run DC contingency analysis for the current case | .agents/skills/ipss-case-ca/SKILL.md |
| Current case network info | .agents/skills/ipss-case-info/SKILL.md |
| Run ACLF for the current case | .agents/skills/ipss-case-aclf/SKILL.md |
| Adjust load Q to a bus-voltage band | .agents/skills/ipss-case-aclf-adjust/SKILL.md |
| Summary report for the current case | .agents/skills/ipss-case-summary/SKILL.md |
| Run a scenario script on the current case | .agents/skills/ipss-case-script/SKILL.md |
| Draw a one-line diagram for the case | .agents/skills/ipss-case-diagram/SKILL.md |