Spaces:
Runtime error
Runtime error
JJ Makely
commited on
Commit
·
04d662a
1
Parent(s):
4abb8db
updates to README.md
Browse files
README.md
CHANGED
|
@@ -11,14 +11,24 @@ pinned: false
|
|
| 11 |
|
| 12 |
# Finetuning Language Models - Toxic Tweets
|
| 13 |
|
| 14 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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 |
-
|
| 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 |

|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 11 |
|
| 12 |
# Finetuning Language Models - Toxic Tweets
|
| 13 |
|
| 14 |
+
[](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}[](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 |

|
| 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).
|