https://github.com/bit-bots/karma

https://github.com/bit-bots/karma

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.1%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: bit-bots
  • License: mit
  • Language: Python
  • Default Branch: master
  • Size: 801 KB
Statistics
  • Stars: 3
  • Watchers: 13
  • Forks: 0
  • Open Issues: 7
  • Releases: 0
Created over 6 years ago · Last pushed over 1 year ago
Metadata Files
Readme License

README.md

Karma

Karma is a simple time tracking system.

Features

  • projects
  • categories
  • project highscores
  • command line interface

Installation

To install the python dependencies, install pipenv which is used for the dependency management in a virtual environment. Install the dependencies with

pipenv sync

Copy settings.py.example to settings.py in the karma folder:

cp karma/settings.py.example karma/settings.py

and customize the settings.py.

The following settings should probably be changed:

  • The secret key
  • The DEBUG setting
  • The ALLOWED_HOSTS
  • The database settings

For instructions on how to use other databases than sqlite, have a look at the Django Documentation.

To initialize the database, run pipenv run ./manage.py migrate

To create an administrator user, run pipenv run ./manage.py createsuperuser.

pipenv run ./manage.py runserver starts the server with the configuration given in the settings.py file.

On the website, you can use the Add Project or Add Category buttons to add projects and categories.

Since we use the karma system with LDAP, there is currently no registration interface. You can instead create users using pipenv run ./manage.py createsuperuser or in the django admin interface which is located at /admin. Navigate to Users -> Add user and insert the user data. If you also want to use LDAP for authentication, use django-auth-ldap. For configuration, have a look at their GitHub page or their documentation.

For production systems it is necessary to additionally run the command pipenv run ./manage.py collectstatic. For production, we recommend to use uwsgi.

Our uwsgi configuration and a Dockerfile can be found at https://github.com/fsinfuhh/dockerfiles/tree/master/karma.

Owner

  • Name: Hamburg Bit-Bots
  • Login: bit-bots
  • Kind: organization
  • Location: Hamburg

Official Github account of Hamburg Bit-Bots

GitHub Events

Total
  • Push event: 2
Last Year
  • Push event: 2

Dependencies

Pipfile pypi
  • Django <3.3
  • django-datetime-widget <0.10
  • django-widget-tweaks <1.5
  • djangorestframework <3.13
Pipfile.lock pypi
  • asgiref ==3.5.0
  • django ==3.2.12
  • django-datetime-widget ==0.9.3
  • django-widget-tweaks ==1.4.9
  • djangorestframework ==3.12.4
  • pytz ==2021.3
  • sqlparse ==0.4.2
.github/workflows/build_image.yml actions
Dockerfile docker
  • debian buster build