Analysis tools for Facebook Messenger data.
- Install the
pipenv
command. - Grab dependencies by running
pipenv install
in the repository root. - Download your Facebook dump in JSON format.
- Place the
messages
directory from the dump in the repository root.
- Execute
run.sh
to launch Jupyter Notebook with dependencies loaded. - Open
notebooks/Setup.ipynb
to get started. (The other notebooks assume that you've completed the setup.)
- To use the VS Code workspace template, it's useful for the virtualenv to be installed in the same
directory as the repo. The corresponding install command is
PIPENV_VENV_IN_PROJECT=true pipenv install --dev
. Note thedev
suffix to get auto-formatting and other useful dev dependencies. - Execute
setup.sh
to install some useful Git hooks (e.g. stripping Jupyter notebooks of their output when you stage changes).