https://github.com/marvinkweyu/assessme

A quiz application that lets instructors create multiple-choice graded assessments, results of which can be downloaded as a CSV file
https://github.com/marvinkweyu/assessme

assessme assessment classroom django docker education quiz

Last synced: 22 days ago
JSON representation

A quiz application that lets instructors create multiple-choice graded assessments, results of which can be downloaded as a CSV file

• Host: GitHub
• URL: https://github.com/marvinkweyu/assessme
• Owner: MarvinKweyu
• License: mit
• Created: 2019-08-08T17:37:57.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-10-17T08:25:01.000Z (7 months ago)
• Last Synced: 2025-03-27T01:46:35.620Z (about 1 month ago)
• Topics: assessme, assessment, classroom, django, docker, education, quiz
• Language: JavaScript
• Homepage:
• Size: 1.14 MB
• Stars: 10
• Watchers: 0
• Forks: 6
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
AssessMe


                

                

[![Python Version](https://img.shields.io/badge/python-3.9-brightgreen.svg)](https://python.org)

[![Django Version](https://img.shields.io/badge/django-3.2-brightgreen.svg)](https://djangoproject.com)

[![CircleCI](https://circleci.com/gh/MarvinKweyu/AssessMe.svg?style=svg)](https://circleci.com/gh/MarvinKweyu/AssessMe)

![Release](https://img.shields.io/github/v/release/MarvinKweyu/AssessMe?include_prereleases)

![Contributors](https://img.shields.io/github/contributors/MarvinKweyu/AssessMe) 

[![View](http://hits.dwyl.com/MarvinKweyu/AssessMe.svg)](http://hits.dwyl.com/MarvinKweyu/AssessMe)

![Docker](https://img.shields.io/docker/pulls/marvinkweyu/assessme_web?logo=AssessMe&style=flat

)



  

  AssessMe Live |

  Docker image 

  



  



 >An applicaition that allows teachers to create quizzes and students to

 take the quiz in relation to their interests

 # Table of Contents

 - [ Key features](#Features)

 - [ Running AssessMe locally ](#Setup)

 - [Contributions](#Contributions)

 - [License](#License)

## Features

---

- Password management

- Quiz timer

- Teacher download results option

# Setup

**Downloading the latest release.**

Knab yourself the latest release version from the page

[release page](https://github.com/MarvinKweyu/AssessMe/releases)

---

### Docker Preview

Run the following command to run the latest version of the docker image:

```bash

docker-compose up

```

### Bare metal development

Create Virtual Env and Install the requirements:

```bash

cd AssessMe

bash develop.sh

```

Finally, run the development server:

```bash

python manage.py runserver --settings=assessme.settings.dev

```

The project will be available at http://127.0.0.1:8000, Login using::

**Teacher**

username: `teacher`

password: `teacher`

**Student**

username: `student`

password: `student`

## Tests

```bash

python manage.py test --settings=assessme.settings.dev

```

## Contributions

---

Contributions are welcome.

Do remember to take a look at the project [contribution guidelines](./CONTRIBUTING.md)

## The AssessMe Contributor Board



    

        

    



## License

---

This project was inspired by [suhail's](https://github.com/suhailvs/django-schools) work on the django quiz application and is released under the [MIT License](https://github.com/MarvinKweyu/AssessMe/blob/master/LICENSE).