ProMoAI & PMAx
ProMoAI is an AI-powered suite for Process Mining that leverages Large Language Models (LLMs) to bridge the gap between natural language and technical process analysis. The framework now includes PMAx, an autonomous agentic system for data-driven insights.
The suite consists of two primary modules:
- ProMoAI (Model Generation): Transforms text or event logs into formal process models (BPMN/Petri nets).
- PMAx (Agentic Analytics): An autonomous multi-agent framework that functions as a virtual process analyst to query event logs and generate data-grounded reports.
Features
1. ProMoAI: Model Generation & Refinement
- Text-to-Model: Generate BPMN or PNML models from natural language descriptions.
- Model Refinement: Upload an existing BPMN or Petri net and use AI to modify or extend it via chat.
- Discovery Baseline: Start with an XES event log to discover an initial model, then refine it using the LLM.
2. PMAx: Agentic Process Mining (New!)
- Autonomous Reasoning: Uses a "divide-and-conquer" architecture with specialized Engineer and Analyst agents.
- Privacy-Preserving: Only lightweight metadata (column names/types) is sent to the LLM. Raw event data never leaves your local environment.
- Deterministic Accuracy: The system generates and executes local Python code (using whitelisted data preprocessing libraries) to compute exact metrics, avoiding LLM hallucinations.
- Comprehensive Reporting: Automatically generates tables, statistical charts, and narrative insights from high-level business questions.
Launching the App
On the Cloud
Access the unified suite directly at: https://promoai.streamlit.app/
Locally
- Clone this repository.
- Install the required environment and packages (see Requirements).
- Run the application:
- Unified Suite (ProMoAI + PMAx):
streamlit run app.py
- Standalone ProMoAI (Legacy Interface):
streamlit run promoai_standalone.py
Installation as Python Library:
You can install the core ProMoAI components via pip:
pip install promoai
Requirements
- Environment: the app is tested on both Python 3.9 and 3.10.
- Dependencies: all required dependencies are listed in the file 'requirements.txt'.
- Packages: all required packages are listed in the file 'packages.txt'.
Citation
If you use this suite in your research, please cite the relevant papers:
ProMoAI (Process Modeling)
@inproceedings{DBLP:conf/ijcai/KouraniB0A24,
author = {Humam Kourani and
Alessandro Berti and
Daniel Schuster and
Wil M. P. van der Aalst},
title = {ProMoAI: Process Modeling with Generative {AI}},
booktitle = {Proceedings of the Thirty-Third International Joint Conference on
Artificial Intelligence, {IJCAI} 2024},
pages = {8708--8712},
publisher = {ijcai.org},
year = {2024},
url = {https://www.ijcai.org/proceedings/2024/1014}
}
1 maintainer
Metadata
1 maintainer
Release files for promoai 2.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| promoai-2.2.2.tar.gz | 98.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| promoai-2.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 194.0 kB
Release files / promoai-2.2.2.tar.gz
| Download URL | promoai-2.2.2.tar.gz |
|---|---|
| Size | 98.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b6cc0384ccadabc67110a3a65326b470224ab4b86f30277e7bb2f4f3d0764167
|
|
BLAKE2b-256 checksum How to use checksums |
771e3c34bb8a44845cb38ff437b802a7528f8bbba592c85f7ed73c5ca77c346b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logRelease files / promoai-2.2.2-py3-none-any.whl
| Download URL | promoai-2.2.2-py3-none-any.whl |
|---|---|
| Size | 95.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1bfdd032491b6dffa2585445269a289a7805759597ed790befd4ede0cb7fe2c1
|
|
BLAKE2b-256 checksum How to use checksums |
02be82c28891517e4d5a5b0ac29e369355887ff1862073fa3b4de512c088e471
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency log
