cs482-toxic-tweets / README.md
JJ Makely
updates to README.md
04d662a
|
raw
history blame
3.46 kB
metadata
title: Cs482 Toxic Tweets
emoji: 
colorFrom: green
colorTo: green
sdk: streamlit
sdk_version: 1.17.0
app_file: app.py
pinned: false

Finetuning Language Models - Toxic Tweets

Sync to Hugging Face hub

See the deployed App on HuggingFace

CS 482 Project - Instructions

Milestone 1 - Development Environment

OS Version

This project was created in Ubuntu 20.04. Thus, steps for installing and developing in Windows are not included.

Distributor ID: Ubuntu
Description: Ubuntu 20.04.6 LTS
Release: 20.04
Codename: focal

Docker Installation

The instructions below will help install Docker on Ubuntu version 20.04.6

## Update list of existing packages
sudo apt update

## Install prerequisite packages
sudo apt install apt-transport-https ca-certificates curl software-properties-common

## Add GPG key for the official Docker repository
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

## Add the Docker repository to APT sources
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"

## Prep to install from docker repo
apt-cache policy docker-ce

## Install docker
sudo apt install docker-ce

## Check if docker is running
sudo systemctl status docker

## Add sudo docker permissions to current user
sudo usermod -aG docker ${USER}[![Sync to Hugging Face hub](https://github.com/jjmakes/cs482-project/actions/workflows/sync_to_hf.yml/badge.svg)](https://github.com/jjmakes/cs482-project/actions/workflows/sync_to_hf.yml)

## VS Code Installation

The instructions below will help install VS Code on Ubuntu version 20.04.6

[Download the VS Code .deb package (64 bit)](https://code.visualstudio.com/download)

Navigate to downloads folder

cd ~/Downloads

Install VS Code (replace with the downloaded package)

sudo apt install ./.deb


## Creating a development environment with docker

[Quick Start Development Container](https://code.visualstudio.com/docs/devcontainers/containers#_quick-start-try-a-development-container)

1. **F1**, _Dev Containers: Open Folder in Container..._
2. Select starting image

Some notable images worth using are:

- Alpine: Barebones Linux OS
- Python3: Container for developing Python 3 Applications

![](./milestone-1.png)


## Milestone 2

App is deployed to [HuggingFace](https://huggingface.co/spaces/jjmakes/cs482-toxic-tweets) via GitHub actions following [instructions provided in this tutorial](https://www.youtube.com/watch?v=8hOzsFETm4I). HuggingFace provides documentation for performing [sentiment analysis with python](https://huggingface.co/blog/sentiment-analysis-python).

### Testing with Streamlit Locally

To test with streamlit, install the project dependencies locally with:

pip3 install -r requirements.txt


To run the project, use:

streamlit run app.py --server.port 8888


The page can be set to hot-reload by selecting `Always Rerun` after a change is made.

Models used are pretrained and provided by [HuggingFace](https://huggingface.co/models?pipeline_tag=text-classification&sort=likes&search=sentiment).