The xAI Toolbox uses Django as a backend framework and React as a frontend framework. The toolbox displays issues from software repositories of SmartSHARK
The following guide will help you to set up the project on your local device.
Requirements and how to get them with Ubuntu 20.04 LTS.
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt-get install python3.9
sudo apt-get install python3.9-dev
sudo apt-get install python3.9-venv
cd ~
sudo apt upate
sudo apt install nodejs npm
- The backend assumes that a MySQL database is already existing for xAI Toolkit (can be empty). If that is not the case, create a database with your favorite tool before running migrate. Otherwise, you can use the SQLite database (not recommended).
- Download the model from here and place it in the folder
backend/models
sudo apt-get install libmysqlclient-dev
git clone https://github.com/benjaminLedel/xai-toolbox.git
cd xai-toolbox
python3.9 -m venv .
source bin/activate
pip install -r requirements.txt
# change database credentials for MySQL DB and the secret key
nano backend/settings.py
# migrate database
python manage.py migrate
# create superuser
python manage.py createsuperuser
cd /srv/www/xaitoolkit/frontend
# install dependencies
npm install
npm run build
run backend in dev mode
cd /srv/www/xaitoolkit
source bin/activate
python manage.py runserver
run frontend in dev mode
cd /srv/www/xaitoolkit/frontend
npm run start