Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: 3 months 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 (4 months ago)
Last Synced: 2024-10-31T19:41:55.571Z (3 months ago)
Topics: assessme, assessment, classroom, django, docker, education, quiz
Language: JavaScript
Homepage:
Size: 1.14 MB
Stars: 10
Watchers: 1
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).