JJ Makely commited on
Commit
04d662a
1 Parent(s): 4abb8db

updates to README.md

Browse files
Files changed (1) hide show
  1. README.md +34 -10
README.md CHANGED
@@ -11,14 +11,24 @@ pinned: false
11
 
12
  # Finetuning Language Models - Toxic Tweets
13
 
14
- ## Milestone 1:
 
 
 
 
 
 
15
 
16
  ## OS Version
17
 
 
 
 
18
  Distributor ID: Ubuntu
19
  Description: Ubuntu 20.04.6 LTS
20
  Release: 20.04
21
  Codename: focal
 
22
 
23
  ## Docker Installation
24
 
@@ -47,20 +57,13 @@ sudo apt install docker-ce
47
  sudo systemctl status docker
48
 
49
  ## Add sudo docker permissions to current user
50
- sudo usermod -aG docker ${USER}
51
-
52
- ## Apply the user membership
53
- su - ${USER}
54
-
55
- ## Check if the user has the docker group added
56
- groups
57
- ```
58
 
59
  ## VS Code Installation
60
 
61
  The instructions below will help install VS Code on Ubuntu version 20.04.6
62
 
63
- (Download the VS Code .deb package (64 bit))[https://code.visualstudio.com/download]
64
 
65
  ```
66
  ## Navigate to downloads folder
@@ -83,3 +86,24 @@ Some notable images worth using are:
83
  - Python3: Container for developing Python 3 Applications
84
 
85
  ![](./milestone-1.png)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
11
 
12
  # Finetuning Language Models - Toxic Tweets
13
 
14
+ [![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)
15
+
16
+ ## [See the deployed App on HuggingFace](https://huggingface.co/spaces/jjmakes/cs482-toxic-tweets)
17
+
18
+ CS 482 Project - [Instructions](https://pantelis.github.io/data-mining/aiml-common/projects/nlp/finetuning-language-models-tweets/index.html)
19
+
20
+ ## Milestone 1 - Development Environment
21
 
22
  ## OS Version
23
 
24
+ This project was created in Ubuntu 20.04. Thus, steps for installing and developing in Windows are not included.
25
+
26
+ ```
27
  Distributor ID: Ubuntu
28
  Description: Ubuntu 20.04.6 LTS
29
  Release: 20.04
30
  Codename: focal
31
+ ```
32
 
33
  ## Docker Installation
34
 
 
57
  sudo systemctl status docker
58
 
59
  ## Add sudo docker permissions to current user
60
+ 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)
 
 
 
 
 
 
 
61
 
62
  ## VS Code Installation
63
 
64
  The instructions below will help install VS Code on Ubuntu version 20.04.6
65
 
66
+ [Download the VS Code .deb package (64 bit)](https://code.visualstudio.com/download)
67
 
68
  ```
69
  ## Navigate to downloads folder
 
86
  - Python3: Container for developing Python 3 Applications
87
 
88
  ![](./milestone-1.png)
89
+
90
+
91
+ ## Milestone 2
92
+
93
+ 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).
94
+
95
+ ### Testing with Streamlit Locally
96
+
97
+ To test with streamlit, install the project dependencies locally with:
98
+ ```
99
+ pip3 install -r requirements.txt
100
+ ```
101
+
102
+ To run the project, use:
103
+ ```
104
+ streamlit run app.py --server.port 8888
105
+ ```
106
+
107
+ The page can be set to hot-reload by selecting `Always Rerun` after a change is made.
108
+
109
+ Models used are pretrained and provided by [HuggingFace](https://huggingface.co/models?pipeline_tag=text-classification&sort=likes&search=sentiment).