thesis / README.md
LennardZuendorf's picture
feat: finally actual final changes
f6d622b unverified

A newer version of the Gradio SDK is available: 4.36.1

Upgrade
metadata
title: Thesis
emoji: πŸŽ“
colorFrom: red
colorTo: yellow
sdk: gradio
sdk_version: 4.7.1
app_file: main.py
pinned: true
license: mit
app_port: 8080
models:
  - microsoft/GODEL-v1_1-large-seq2seq
tags:
  - CHAT
  - XAI
  - SHAP
  - GODEL
  - Gradio
disable_embedding: true

Bachelor Thesis Webapp

πŸ“œ Info:

This is the UI showcase for my thesis about the interpretability of LLM based chatbot application and applications of XAI.

Current Release: v1.3.1

πŸ”— Links:

GitHub Repository

Huggingface Spaces Showcase

Non-Public Showcase

πŸ—οΈ Tech Stack:

Language and Framework: Python

Noteable Packages: πŸ€— Transformers, FastAPI, Gradio, SHAP, BERTViz

πŸ‘¨β€πŸ’» Author:

Author: @LennardZuendorf

Thesis Supervisor: Prof. Dr. Simbeck
Second Corrector: Prof. Dr. Hochstein

This Project was part of my studies of Business Computing at the University of Applied Science for Technology and Business Berlin (HTW Berlin).

Running the Project:

🐍 Python with FastAPI :

(This assumes you have set up a python environment, I recommend using a virtual environment.)

  1. Clone the repository using git or GitHub cli.
  2. Start the (virtual) environment.
  3. Set the environment variable "HOSTING", i.e. like this export HOSTING=local, see fastAPI Docu
  4. Install the requirements using pip install -r requirements.txt
  5. Run the app using uvicorn main:app. You can add --reload to enable hot reloading. The app will be available at localhost:8000.

🐳 Dockerfile :

(This assumes you have set up docker desktop or are using a hosting service able to handle Dockerfiles.)

  1. Clone the repository using git or GitHub cli.
  2. Build the docker image using docker build -t thesis-webapp -f Dockerfile . ., the command commented in the docker file or the command referenced by your hosting service.
  3. Run the docker image using docker run --name thesis-webapp -e HOSTING=local -p 8080:8080 thesis-webapp, the command commented in the docker file or the command referenced by your hosting service.
  4. The app will be available at localhost:8080. If you are using a hosting service, the port may be different.

🐳 Docker Image :

(This assumes you have set up docker desktop or are using a hosting service able to handle Docker images.)

  1. Pull the docker image from ghcr using docker pull ghcr.io/LennardZuendorf/thesis-webapp:1.3.1.
  2. Run the docker image in terminal using docker run --name thesis-webapp -e PW=test -p 8080:8080 lennardzuendorf/thesis-webapp::1.3.1, the command commented in the docker file or the command referenced by your hosting service.
  3. The app will be available at localhost:8080. If you are using a hosting service, the port may be different.

πŸ“ License and Credits:

This project is licensed under the MIT License, see LICENSE for more information. Please cite this project, it's author and my university if you use it in your work.

  • Title: Building an Interpretable Natural Language AI Tool based on Transformer Models and approaches of Explainable AI.
  • Date: 2024-02-14
  • Author: Lennard ZΓΌndorf
  • University: HTW Berlin

See code for in detailed credits, work is strongly based on:

captum

shap

GODEL

Mistral 7B (Instruct)

Custom Component (/components/iframe/)

Is based on Gradio component, see individual README for full changelog.