dionysus - Avatar chart generator

dionysus is an open source CLI app primarily aimed at teachers that charts student results for display using avatars, nicknames, or student names.

Currently in alpha release, fuller features, automated install/packaging, and a full GUI/webapp are future goals. Supports latest two python minor versions - currently 3.13 and 3.14.

Excitedly welcoming contributors!

Contact/feedback

Any comments or feedback are welcome and desired! I would love to know if you are using this project, if it has been useful, and any problems or suggestions for improvements. Leave a comment or raise an issue in the Github repository, or privately .

Installation

Currently to use the application, you must clone or download the project from here on github. See releases for a zip or tar.gz. You will need Python 3.10+ and uv. Unzip the project if necessary, navigate to the project directory and run uv sync to install dependencies. For development you will also need uv sync --all-extras.

Running the application

Click on app_main.py in the project folder, or navigate to the folder and run python -m app_main/python3 app_main.py in terminal (depending on OS).

Versioning

As much as possible this project will follow Semantic Versioning.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

toonarmycaptain 💻 📖 🎨 🤔 🚧	Przemysław Pietras 🚇 📖	Piotr Czajka 💻 ⚠️	Saurabh Chaturvedi 💻	M. Alex Boyd 💻 ⚠️	José María Domínguez 🚇	AbdullahElagha 📖
HCamberos 💻	Wu Tingfeng 💻 🔧

This project follows the all-contributors specification. Contributions of any kind welcome!