Installation¶
Stable release¶
To install kibitzr, run these commands in your terminal:
$ virtualenv venv
$ source venv/bin/activate
$ pip install kibitzr
This is the preferred method to install kibitzr, as it will always install the most recent stable release.
If you don’t have pip installed, this Python installation guide can guide you through the process.
Dependencies¶
Kibitzr has many integrations and depending on what features are used may require additional setup.
The recommended way to have all dependencies installed and configured is to use Docker.
Docker¶
Make sure Docker is installed.
Run the following commands to pull docker image, create example configuration and run kibitzr:
mkdir kzr-example
cd kzr-example
docker run -v $PWD:/root --rm peterdemin/kibitzr init
docker run -v $PWD:/root --rm peterdemin/kibitzr run
Manual installation¶
The hard way is to install all dependencies. Consult Dockerfile and Try kibitzr on GCP Free Tier tutorial on required steps.
Kibitzr uses several Python packages, that have C extensions. When installed through pip, they are compiling libraries. This process requires gcc (which is almost always present) and Python header files (which are not installed on vanilla Linux).
You can either install those dependencies using OS installer:
apt install python-lazy-object-proxy python-yaml
or install Python headers:
apt install python-dev
Optional dependencies¶
Some of the dependencies are used only when corresponding features are used in kibitzr.yml
.
changes
transform. Requires git.delay
andscenario
- triggers for using Firefox as a fetcher.Installing Firefox can be cumbersome, please refer to FireFox installation guide.
HTML selectors
xpath
,css
andtag
requirelxml
which compiles low-level extensions during pip installation. So again, you either installpython-dev
, or installlxml
from OS repo:apt install python-lxml