Skip to main content

A simple DES modeling and simulation environment based on simpy, camunda modeler, and tkinter / pixi.js;

Project description

Camunda-Modeler-based creation of SimPy discrete event simulation models

Wouldn't it be cool to combine the block-based process modeling experience of commercial discrete event simulation packages with the amenities of proper IDE-based source-code editing? (Think Arena / Anylogic / ExtendSim / Plant Simulation / ... but with simple integration of third-party libraries, industry-standard interfaces, unit- and integration testing, dockerization, serverless execution in the cloud of your choice... and even actually working auto-completion! :D)

And all that not only for free, but using the worlds most popular language for data analytics and machine learning?

Casymda enables you to create SimPy3 simulation models, with help of BPMN and the battle-tested Camunda-Modeler.

Created BPMN process diagrams are parsed and converted to Python-code, combining visual oversight of model structure with code-based definition of model behavior. Immediately executable, including a token-based process animation, allowing for space-discrete entity movements, and ready to be wrapped as a gym-environment to let a machine-learning algorithm find a control strategy.

Further information and sample projects: (Deutsch/German)


From PyPI:

pip install casymda


  • connectable blocks for processing of entities
  • graphical model description via camunda modeler
  • process visualization browser-based or via tkinter
  • space-discrete tilemap-movements of entities
  • Gym-interface implementation for connection of reinforcment learning algorithms
  • gradually typed (checkout pyright for vscode:

Coming soon:


Basic features are illustrated as part of the example models (which also serve as integration tests):

  • basics:
    • bpmn-based generation of a simple model file
    • run the generated model
    • process visualization via tkinter
    • browser-based visualization (served with flask, animated with pixijs)
  • resources:
    • seize and release a resource via graphical modeling
  • tilemap:
  • gym:
    • RL essentials: let an agent learn how to sort fruits according to their type (built on gym and stable-baselines )

For setup just clone the repository and install casymda (virtual environment recommended). See basics-visual-run-tkinter for an example of how to cope with python-path issues.



This project trusts Black for formatting, Sonarqube for static code analysis, and pytest for unit & integration testing. Developed and tested on Linux (Ubuntu 18.04), Python 3.7.5. Tests can be carried out inside a docker-container, optionally including an installation from pypi to verify a successful upload.


sonarqube server (public docker image):

docker-compose up sonarqube

sonar-scanner (public docker image):

docker-compose up analysis

(run a docker-based unit-test first for coverage-reporting)
(remember to share your drive via Docker-Desktop settings if necessary, to be re-applied after each password change)


pytest --cov-report term --cov=src/casymda/ tests/

For Docker-based tests see docker-compose.yml

docker-compose up unit-test
docker-compose up examples-test
docker-compose up examples-test-pypi

Virtual environment setup

python3 -m venv venv

Editable installation

pip install -e .

Publish to pypi

python sdist

twine upload dist/*

pip install twine if necessary,
remember to set the version in and src/casymda as required


feedback / ideas / discussion / cheering / complaints welcome

MIT License


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

casymda-0.2.12.tar.gz (32.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page