# 🔍 POWL Miner
**Process Mining with the Partially Ordered Workflow Language**
The POWL Miner allows you to perform **process discovery from event logs**, leveraging the **Partially Ordered Workflow Language (POWL) 2.0**. The generated POWL 2.0 models can be viewed and exported as BPMNs or Petri nets (PNML). For more details on POWL 2.0, please refer to the paper: [**Unlocking Non-Block-Structured Decisions: Inductive Mining with Choice Graphs**](https://arxiv.org/abs/2505.07052).
## 🚀 Launching as a Streamlit App
You have two options for running the POWL Miner as a Streamlit App:
### ☁️ On the Cloud
Access the hosted version directly:
[**https://powl-miner.streamlit.app/**](https://powl-miner.streamlit.app/)
### 💻 Locally
To run the Streamlit application on your own machine:
1. Clone this repository.
2. Install the required dependencies ('requirements.txt') and packages ('packages.txt').
3. Run:
```bash
streamlit run app.py
```
## 🐍 Installing as a Python Library
You can also install the POWL Miner as a Python library to integrate its functionalities into your own scripts.
1. Install the required packages ('packages.txt').
2. Install the library via pip:
```bash
pip install powl
```
**👉 Usage Example:**
Check the `examples/` directory of this repository.
Raw data
{
"_id": null,
"home_page": "https://github.com/humam-kourani/powl",
"name": "powl",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "process mining, business process management",
"author": "Humam Kourani",
"author_email": "humam.kourani@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d7/b6/e7807148a90be9e0f91afec44fa849da97a8d11933b2c9f709a0c72f8dd6/powl-2.0.0.tar.gz",
"platform": null,
"description": "# \ud83d\udd0d POWL Miner\r\n**Process Mining with the Partially Ordered Workflow Language**\r\n\r\nThe POWL Miner allows you to perform **process discovery from event logs**, leveraging the **Partially Ordered Workflow Language (POWL) 2.0**. The generated POWL 2.0 models can be viewed and exported as BPMNs or Petri nets (PNML). For more details on POWL 2.0, please refer to the paper: [**Unlocking Non-Block-Structured Decisions: Inductive Mining with Choice Graphs**](https://arxiv.org/abs/2505.07052).\r\n\r\n\r\n## \ud83d\ude80 Launching as a Streamlit App\r\n\r\nYou have two options for running the POWL Miner as a Streamlit App:\r\n\r\n### \u2601\ufe0f On the Cloud\r\nAccess the hosted version directly:\r\n[**https://powl-miner.streamlit.app/**](https://powl-miner.streamlit.app/)\r\n\r\n### \ud83d\udcbb Locally\r\nTo run the Streamlit application on your own machine:\r\n\r\n 1. Clone this repository.\r\n 2. Install the required dependencies ('requirements.txt') and packages ('packages.txt').\r\n 3. Run:\r\n ```bash\r\n streamlit run app.py\r\n ```\r\n\r\n## \ud83d\udc0d Installing as a Python Library\r\n\r\nYou can also install the POWL Miner as a Python library to integrate its functionalities into your own scripts.\r\n\r\n1. Install the required packages ('packages.txt').\r\n2. Install the library via pip:\r\n ```bash\r\n pip install powl\r\n ```\r\n\r\n**\ud83d\udc49 Usage Example:**\r\n Check the `examples/` directory of this repository.\r\n\r\n",
"bugtrack_url": null,
"license": "AGPL-3.0 license",
"summary": "POWL Miner: Process Mining with the Partially Ordered Workflow Language",
"version": "2.0.0",
"project_urls": {
"Homepage": "https://github.com/humam-kourani/powl"
},
"split_keywords": [
"process mining",
" business process management"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0a5902e00cebe28fce75e2f715808d2f5ccc2b5ad4c00f3263d315e7b6874148",
"md5": "ef7c289a60dd45281a3163655e2993b5",
"sha256": "1e80f22cfdb5aeac221e3ada9b1314ea1a85c415474b447973bb7b74bf38de11"
},
"downloads": -1,
"filename": "powl-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ef7c289a60dd45281a3163655e2993b5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 95712,
"upload_time": "2025-07-31T16:36:41",
"upload_time_iso_8601": "2025-07-31T16:36:41.719377Z",
"url": "https://files.pythonhosted.org/packages/0a/59/02e00cebe28fce75e2f715808d2f5ccc2b5ad4c00f3263d315e7b6874148/powl-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d7b6e7807148a90be9e0f91afec44fa849da97a8d11933b2c9f709a0c72f8dd6",
"md5": "a26599b0b4976d1dea986e5479a57c57",
"sha256": "f0e4fcdff9b5a856c7a3f1a16be405570c75fd6227e40dbbc200028d98ae557b"
},
"downloads": -1,
"filename": "powl-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "a26599b0b4976d1dea986e5479a57c57",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 61802,
"upload_time": "2025-07-31T16:36:43",
"upload_time_iso_8601": "2025-07-31T16:36:43.061000Z",
"url": "https://files.pythonhosted.org/packages/d7/b6/e7807148a90be9e0f91afec44fa849da97a8d11933b2c9f709a0c72f8dd6/powl-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-31 16:36:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "humam-kourani",
"github_project": "powl",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "pm4py",
"specs": []
},
{
"name": "graphviz",
"specs": []
},
{
"name": "rustxes",
"specs": []
},
{
"name": "streamlit",
"specs": []
},
{
"name": "networkx",
"specs": []
}
],
"lcname": "powl"
}
JSON
