Skip to content
RSS/JSON Aggregator and Search Engine for IT Jobs
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Hackwage is a RSS/JSON aggregator and search-engine for IT Jobs. It can be easily adapted for other projects, for example to fetch and search News.

The website is based on Python/Django and ElasticSearch, while the live data is ingested via NodeJS.

How to run it (Debian)

Create Python Virtual Env

$ git clone
$ cd hackwage
$ virtualenv -p python3 venv3
$ source venv3/bin/activate
$ pip install -r requirements.txt

Run ElasticSearch

Install the latest ElasticSearch on your Debian box, as documented here. Then start it:

$ sudo systemctl start elasticsearch

Setup NodeJS and start ingesting data

$ cd node
$ npm install
$ npm run ingest

The script will try to fetch all the default data sources, you shouldn't get any error at this stage.

Setup a Cron Job

You can set up a cronjob to fetch data every hour. Just run crontab -e and add a line like this:

0 * * * * cd /hackwage-path/node/ && npm run ingest >/dev/null 2>&1

Setup and run Django server

$ ln -s `pwd`/dj/  dj/
$ python migrate
$ python runserver

Now you should be able to access hackwage on you local machine on port 8000.


Hackwage makes use of Memcached cache the home page. It's already set up in the default settings, so you just need to install and run Memecached:

$ sudo apt install memcached
$ sudo systemctl start memcached

Adding RSS sources

You can add any number of RSS source url, editing the file /sources.json. It should be a JSON file with a list of objects structured like this one:

    "name": "StackOverflow Jobs",
    "url": "",

Elasticsearch Mappings

Elasticsearch works out of the box with any JSON blob of data. But to get decent search results and index only what is necessary, you might want to setup the object mappings. Hackwage uses an "rss" index and a "item" doc_type. You can configure the mappings doing this PUT request:

PUT http://localhost:9200/rss/item/

  "item": {
    "properties": {
      "title": {
        "type": "text",
        "analyzer": "english"
      "body": {
        "type": "text",
        "analyzer": "english"
      "body_html": {
        "type": "keyword"
      "category": {
        "type": "keyword"
      "link": {
        "type": "keyword"
      "pubDate": {
        "type": "date"
      "source": {
        "type": "keyword"


  • Dockerize, anyone ?

Hackwage clones ?

Hackwage is distributed under GPL3. So you can deploy as many clones of as you wish, as long as you link back to this page and share any improvements you made to it.

You can’t perform that action at this time.