diff --git a/.gitignore b/.gitignore
index 4763acb..08eebad 100644
--- a/.gitignore
+++ b/.gitignore
@@ -130,4 +130,7 @@ dist
.pnp.*
# misc
-*.DS_STORE
\ No newline at end of file
+*.DS_STORE
+
+# python
+*.pyc
\ No newline at end of file
diff --git a/README.md b/README.md
index 2454dd3..2001e46 100644
--- a/README.md
+++ b/README.md
@@ -16,3 +16,36 @@ Make a copy of the ``.env.example`` file and make the following changes.
2. Paste the username and password provided in MongoDB Atlas (if you should have access but do not, please contact @waseem-polus)
3. Paste the connection URL provided provided in MongoDB Atlas. Include the password and username fields using ``${VARIABLE}`` syntax to embed the value of the variable
+
+## Run Scrapers locally
+**Prerequisites**
+- python3
+- pipenv
+
+**Installing dependencies**
+Navigate to ``scrapers/`` and open the virtual environment using
+```bash
+pipenv shell
+```
+Then install dependencies using
+```bash
+pipenv install
+```
+
+**Scraper Usage**
+To create build a Docker Image use
+```bash
+pipenv run build
+```
+to run a docker container "smarecontainer" use
+```bash
+pipenv run cont
+```
+then
+```bash
+# Scrape Craigsist homepage
+pipenv run craigslist
+
+# Scrape Facebook Marketplace homepage
+pipenv run facebook
+```
diff --git a/github-metrics.svg b/github-metrics.svg
index a818099..0dfe375 100644
--- a/github-metrics.svg
+++ b/github-metrics.svg
@@ -25,31 +25,31 @@
- Deployed 148 times
+ Deployed 164 times
+ 