updaging instructions;

Author: dbickson

INSTALL.md

@@ -15,6 +15,10 @@ sudo apt -y install libgl1-mesa-glx
 python3.8 -m pip install --upgrade pip
 ```
 
+## Mac OS setup
+```bash
+brew install ffmpeg@4
+```
 
 # Pip Package setup
 
@@ -117,3 +121,14 @@ conda install nomkl
 conda install numpy scipy pandas tensorflow
 conda remove mkl mkl-service # may fail, don't worry
 ```
+
+Error on Mac M1: `AttributeError: partially initialized module 'cv2' has no attribute 'gapi_wip_gst_GStreamerPipeline' (most likely due to a circular import)`
+Solution: downgrade your cv2 version to 4.5.5.64 using the command `python.XX -m pip install -U opencv-python==4.5.5.64` where XX is your python version.
+
+Error on Mac M1: library not loaded when trying to import cv2 `ImportError: dlopen(/Users/mikasnoopy/homebrew/lib/python3.9/site-packages/cv2/python-3.9/cv2.cpython-39-darwin.so, 2): Library not loaded: /Users/mikasnoopy/homebrew/opt/dav1d/lib/libdav1d.5.dylib
+  Referenced from: /Users/mikasnoopy/homebrew/opt/ffmpeg@4/lib/libavcodec.58.dylib
+  Reason: image not found
+` or any similar error.
+Solution: Downgrade your ffmpg using `brew remove ffmpeg; brew install ffmpeg@4`
+
+

RUN.md

@@ -456,8 +456,10 @@ Currently we extract frame 1 per sec, please reach out if you need other support
 ## Debugging fastdup <a name="debug"/>
 
 To debug program execution the following is recommended
-- Make sure you have upgraded fastdup to the latest version, we release versions a couple of times a week.
+- Make sure you have upgraded fastdup to the latest version, we release versions a couple of times a week. 
+- In case of installation failure try to upgrade your pip version to the latest using `python3.XX -m pip install -U pip` where XX is your python version.
 - It is recommneded to debug in a python shell (and not in a Jupyter notebook)
 - Run with `verbose=1` to get additional traces
 - Run with `num_images=10` to run on a small subset of your data before running on the full dataset.
+- In a python shell run `import fastdup; help(fastdup)` to see function documentation.
 - If the issue persist please join our [Slack Channel]("https://join.slack.com/t/visualdatabase/shared_invite/zt-19jaydbjn-lNDEDkgvSI1QwbTXSY6dlA")