https://github.com/viadee/workaround-brainstormer
Hypothesis: We will likely see this workaround in your business process
https://github.com/viadee/workaround-brainstormer
bpm creativity llm research
Last synced: 5 days ago
JSON representation
Hypothesis: We will likely see this workaround in your business process
- Host: GitHub
- URL: https://github.com/viadee/workaround-brainstormer
- Owner: viadee
- License: bsd-3-clause
- Created: 2025-04-23T08:39:38.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-04T20:23:55.000Z (30 days ago)
- Last Synced: 2026-05-04T21:29:08.525Z (30 days ago)
- Topics: bpm, creativity, llm, research
- Language: HTML
- Homepage:
- Size: 5.59 MB
- Stars: 4
- Watchers: 5
- Forks: 0
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Workaround Brainstormer
## ℹ️ Description
Workaround Brainstormer is a web application designed to facilitate the identification of workarounds based on a process description or bpmn diagram in an interactive way.
It`s a generative AI approach that helps to identify workarounds in situations where no process data is available for process mining.
You can try out the tool at the following link: **https://brainstormer.cwa.viadee.cloud/index.html**
> [!NOTE]
> The tool was created as part of the [Change.WorkAROUND](https://www.changeworkaround.de) research project by the [viadee](https://www.viadee.de) Data & AI-Team. The project Change.WorkAROUND is supported by the German [BMFTR](https://www.bmftr.bund.de) since 2023 in the ["Zukunft der Wertschöpfung"](https://www.zukunft-der-wertschoepfung.de) program with the goal to improve the abiblity to adapt and innovate in a dynamic context.
## ⭐ Features
- LLM based workaround generation
- Visual representation of the workarounds as a network graph
- Control mechanisms to facilitate the generation process
The tool contains the [CWA Corpus](rag/workarounds_corpus.csv), i.e. a list auf workarounds found in real industry processes and described in a structured way. This corpus is used to guide an LLM when creating plausible workarounds in new processes through few-shot examples.
Both the [CWA Corpus](rag/workarounds_corpus.csv) and the software tool are licensed under the [BSD 3-Clause License](LICENSE).
## How it works
https://github.com/user-attachments/assets/dd0d4a32-e647-4089-b7b8-37ae73847dd8
## Website Content
The public-facing landing pages are maintained directly as static HTML in `static/`.
Quarto source files are no longer part of the repository.
# Getting Started
## Installation
1. Clone this repository and create a python virtual environment
2. Install the dependencies
```
pip install .
```
3. Create a .env file based on the .envtemplate and set you variables
4. Run the flask server for development
```
python run.py
```
5. Or run a production server
```
pip install gunicorn
gunicorn run:app --workers=4 --bind 0.0.0.0:5000
```
## Logging Configuration
The application supports environment-specific logging to help with debugging in development and protect sensitive data in production.
### Setting Log Levels
Set the `ENVIRONMENT` variable in your `.env` file:
```bash
# Development mode - detailed logging
ENVIRONMENT=dev
# Production mode - limited logging (default)
ENVIRONMENT=prod
```
### Features
- **Dev Mode**: Full details including request content, LLM responses, and API parameters
- **Prod Mode**: Limited logging with sensitive information redacted and API keys masked
For detailed information, see [LOGGING.md](LOGGING.md).
The first implementation of the concept was created by [Fresh-P](https://github.com/Fresh-P) as part of his master thesis in cooperation with the University of Münster and viadee in 2024.