Nabaztag server based on Netty
Java JavaScript CoffeeScript Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Running the stack locally


(Commands are given assuming an Ubuntu 11.10 machine)

Front side

Rake & Ruby stuff

Rake is needed to build the front-end: sudo apt-get install rake

You'll need the haml Gem to compile haml templates: sudo gem install haml

Jammit is needed to package assets: sudo gem install jammit

FSSM is needed to monitor changes in the Web front-end files and recompile everything: sudo gem install fssm.


You'll also need the NodeJS Package Manager (npm) to be able to compile Less CSS files and Coffee Script:

sudo apt-get install npm
npm install coffee-script
npm install less

By default the binaries are installed to $HOME/bin. Ensure that this folder is on your $PATH !

Server side


The data is stored in Mongo DB, so you'll need to install it too: sudo apt-get install mongodb.

MongoDB listens to only by default. The Java components are connecting to localhost. Depending of your system configuration localhost can mean different things. If you encounter connection issues while building the Java components here are a couple of things to try:

  • On some Ubuntu systems an alias is set to your hostname on in /etc/hosts. If you encounter connections problems, it's the first place to look at. You should be able to safely delete the line in /etc/hosts.
  • Edit your MongoDB configuration (/etc/mongodb.conf) and comment the bind_ip line, then restart MongoDB. It should now listen on all interfaces and connection should succeed regardless of the IP address used. (Warning: Keep in mind that anybody can connect to your mongodb server with this solution)


To build the Java components, you'll need Maven: sudo apt-get install maven2

Building the web front-end

Go to the web-front/ folder and use: rake.

Building the Java components

Go to the root folder, and: mvn clean install.


To start the whole stack: mvn -f web/pom.xml exec:java -DfrenchTtsUrl=http://localhost/

(TODO: Document the frenchTtsUrl property.)

This will start a webserver on port 8999. Try http://localhost:8999/index.html

You can also start rake on a separate terminal to monitor your changes in the front-end code and re-publish them:

cd web-front/
mkdir public
rake watch


The violet standard API is still accurate:

There is a new way to make API calls as well!

tts sample: (tts is currently only available in french)

play mp3: