Data processing pipelines for loading, processing and visualizing data about the Knesset
We are in the process of migrating to airflow, see airflow/README.md for details.
Uses the datapackage pipelines and DataFlows frameworks.
Follow this method to get started quickly with exploration, processing and testing of the knesset data.
Docker is required to run the notebooks to provide a consistent environment.
Install Docker for Windows, Mac or Linux
Pull the latest Docker image
docker pull orihoch/knesset-data-pipelines
Create a directory which will be shared between the host PC and the container:
sudo mkdir -p /opt/knesset-data-pipelines
Start the Jupyter lab server:
docker run -it -p 8888:8888 --entrypoint jupyter \
-v /opt/knesset-data-pipelines:/pipelines \
orihoch/knesset-data-pipelines lab --allow-root --ip 0.0.0.0 --no-browser \
--NotebookApp.token= --NotebookApp.custom_display_url=http://localhost:8888/
Access the server at http://localhost:8888/
Open a terminal inside the Jupyter Lab web-ui, and clone the knesset-data-pipelines project:
git clone https://github.com/hasadna/knesset-data-pipelines.git .
You should now see the project files on the left sidebar.
Access the jupyter-notebooks directory and open one of the available notebooks.
You can now add or make modifications to the notebooks, then open a pull request with your changes.
You can also modify the pipelines code from the host machine and it will be reflected in the notebook environment.
From your local PC, clone the repository into ./knesset-data-pipelines:
git clone https://github.com/hasadna/knesset-data-pipelines.git .
Change directory:
cd knesset-data-pipelines
Run with Docker, mounting the local directory
docker run -it -p 8888:8888 --entrypoint jupyter \
-v `pwd`:/pipelines \
orihoch/knesset-data-pipelines lab --allow-root --ip 0.0.0.0 --no-browser \
--NotebookApp.token= --NotebookApp.custom_display_url=http://localhost:8888/
When running using this setup, you might have permission problems, fix it giving yourself ownership:
sudo chown -R $USER .
Following instructions were tested with Ubuntu 18.04
Install system dependencies:
sudo apt-get install python3.6 python3.6-dev build-essential libxml2-dev libxslt1-dev libleveldb1v5 libleveldb-dev \
python3-pip bash jq git openssl antiword python3-venv
Install Python dependencies:
python3.6 -m venv env
source env/bin/activate
pip install 'https://github.com/OriHoch/datapackage-pipelines/archive/1.7.1-oh-2.zip#egg=datapackage-pipelines[speedup]'
pip install wheel
pip install psycopg2-binary knesset-data requests[socks] botocore boto3 python-dotenv google-cloud-storage sh
pip install datapackage-pipelines-metrics psutil crcmod jsonpickle tika kvfile pyquery dataflows==0.0.14 pymongo \
tabulate jupyter jupyterlab
pip install -e .
Start environment (these steps are required each time before starting to run pipelines):
source env/bin/activate
export KNESSET_PIPELINES_DATA_PATH=`pwd`/data
Now you can run pipelines with dpp or start the notebook server with jupyter lab
Looking to contribute? check out the Help Wanted Issues or the Noob Friendly Issues for some ideas.
Useful resources for getting acquainted: