https://github.com/toonarmycaptain/dionysus

Student avatar score chart generator
https://github.com/toonarmycaptain/dionysus

avatar chart charts-student dionysus education educational graph hacktoberfest student teacher

Last synced: 5 months ago
JSON representation

Student avatar score chart generator

• Host: GitHub
• URL: https://github.com/toonarmycaptain/dionysus
• Owner: toonarmycaptain
• License: agpl-3.0
• Created: 2018-08-22T05:05:02.000Z (almost 8 years ago)
• Default Branch: development
• Last Pushed: 2025-12-16T20:03:51.000Z (6 months ago)
• Last Synced: 2025-12-20T05:22:16.829Z (6 months ago)
• Topics: avatar, chart, charts-student, dionysus, education, educational, graph, hacktoberfest, student, teacher
• Language: Python
• Homepage:
• Size: 1.78 MB
• Stars: 10
• Watchers: 1
• Forks: 14
• Open Issues: 29
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
## dionysus - Avatar chart generator

[![All Contributors](https://img.shields.io/badge/all_contributors-9-orange.svg?style=flat-square)](#contributors-)

[![Build status](https://ci.appveyor.com/api/projects/status/yb33uwd13tkv7l79?svg=true)](https://ci.appveyor.com/project/toonarmycaptain/dionysus) 

[![Coverage Status](https://coveralls.io/repos/github/toonarmycaptain/dionysus/badge.svg)](https://coveralls.io/github/toonarmycaptain/dionysus) 

[![codecov](https://codecov.io/gh/toonarmycaptain/dionysus/branch/master/graph/badge.svg)](https://codecov.io/gh/toonarmycaptain/dionysus)

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/d24e9508258849c2b40760fce3448c6b)](https://www.codacy.com/app/toonarmycaptain/dionysus?utm_source=github.com&utm_medium=referral&utm_content=toonarmycaptain/dionysus&utm_campaign=Badge_Grade) 

[![CodeFactor](https://www.codefactor.io/repository/github/toonarmycaptain/dionysus/badge/master)](https://www.codefactor.io/repository/github/toonarmycaptain/dionysus/overview/master) 

[![Updates](https://pyup.io/repos/github/toonarmycaptain/dionysus/shield.svg)](https://pyup.io/repos/github/toonarmycaptain/dionysus/) 

[![Python 3](https://pyup.io/repos/github/toonarmycaptain/dionysus/python-3-shield.svg)](https://pyup.io/repos/github/toonarmycaptain/dionysus/) 

**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](https://github.com/toonarmycaptain/dionysus/issues/new) in the [Github repository](https://github.com/toonarmycaptain/dionysus), or privately [![Say Thanks!](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/toonarmycaptain).

### Installation

Currently to use the application, you must clone or download the project from here on github. See [releases](https://github.com/toonarmycaptain/dionysus/releases) for a `zip` or `tar.gz`.

You will need Python 3.10+ and [uv](https://docs.astral.sh/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](https://semver.org/).

   

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/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](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!