Setup

Setting Up a Local Dev Environment

Installing dependencies

All shellprompts assume you are running debian or ubuntu, use whatever means you want to install things.

Install Festival

$ sudo apt-get install festival

Install rabbitmq

$ sudo apt-get install rabbitmq-server

Set up rabbitmq for use with herald

$ sudo rabbitmqctl add_user herald_user dlareh
$ sudo rabbitmqctl add_vhost herald_queue
$ sudo rabbitmqctl set_permissions -p herald_queue herald_user "" ".*" ".*"

Install python virtualenv

$ sudo apt-get install python-virtualenv

Clone Repo

$ git clone git@github.com:saolsen/herald.git

Set up virtualenv

$ cd herald
$ virtualenv --no-site-packages heraldenv
$ source heraldenv/bin/activate
$ pip install -r requirements.txt

Run project locally

$ cd src
$ zsh start_everything.sh

What is happening

When you run start_everything it starts a new tmux session and opens three windows.

• The festival server daemon, this is what actuially processes the text into audio.
• The celery daemon, this sits on top of rabbitmq and processes jobs sent by the web front.
• The web server

You should be able to hit http://localhost:5000/ and see "So that part is good."