fdias78git/dwsim-claude-integration

DWSIM Automation

AI-powered chemical process simulation for everyone.


A Python library + Claude Code agent for automating
DWSIM simulations
with natural language.


Quick Start ·
AI Setup ·
Commands ·
Property Packages ·
Full Setup Guide

---

Disclaimer: This is an unofficial community project. It is not affiliated with, endorsed by, or maintained by the DWSIM development team. This library simply wraps the public automation interface of DWSIM, which is an independent open-source chemical process simulator created by Daniel Medeiros.

---

What This Is

DWSIM Automation bridges the gap between AI and chemical engineering. It gives you two things:

1. Python Library (src/) – A clean, Pythonic API over DWSIM’s .NET automation interface. Build flowsheets, run flash calculations, configure unit operations, access the compound database, and generate reports – all from Python, no GUI needed.

2. Claude Code Integration (.claude/) – A specialized AI agent (dwsim-expert), slash commands (/dwsim, /dwsim-flash, /dwsim-props), and a skill that let Claude Code act as your virtual chemical engineer. Describe what you want in plain language, and the AI writes and runs the simulation for you.

Tip: You can use each part independently. Want just the AI agent without the Python library? Copy only the .claude/ folder. Want just the Python API without AI? Use src/ directly.

---

Why This Exists

Process simulation software has traditionally been locked behind expensive licenses and steep learning curves. DWSIM changed that by being free and open source. This project takes it one step further: what if you could describe a simulation in plain English and have AI build it for you?

Whether you are a student learning thermodynamics, a researcher prototyping a process, or an engineer automating repetitive calculations – this toolkit is for you.

---

Quick Start

5-Minute Setup

# 1. Clone
git clone https://github.com/fdias78git/dwsim-claude-integration.git
cd dwsim-automation

# 2. Virtual environment
python -m venv venv
venv\Scripts\activate        # Windows
source venv/bin/activate     # Linux / macOS

# 3. Install
pip install -r requirements.txt

# 4. Point to your DWSIM installation (pick one)
$env:DWSIM_PATH = "C:\Program Files\DWSIM"      # Windows PowerShell
export DWSIM_PATH=/opt/dwsim                      # Linux / macOS

# 5. Verify
python run.py --check