Grunt, Express, Bootstrap, OAuth2 agent

npm install gebo-server
12 downloads in the last day
27 downloads in the last week
109 downloads in the last month


Historically, the name gebo spoke to this software's underlying workflow and technology. I.e., Grunt, Express, Bootstrap, and OAuth2.

Now it is simply a name for the lowly artificial agent that is rocking your world.

Getting started

There are two ways to get a gebo server up and running:

  1. Clone it from GitHub

  2. Install it via npm

But before all that, there are a few things you'll need...

Setting the stage

Install your database (MongoDB)

You're going to need MongoDB on your system, if you haven't got it already:

Start MongoDB by executing this at the command line:

sudo service mongodb start


If you don't have Node, you're not going anywhere:

sudo apt-get install nodejs


gebo-server requires the bcrypt package, which is compiled with g++:

sudo apt-get install g++


Node Package Manager is needed to install all of gebo-server's dependencies. It should be installed automatically along with Node (see above). If, for some reason, it wasn't, run:

sudo apt-get install npm


Install the Bower package manager globally with the -g option:

sudo npm install -g bower

Clone or npm?

As stated, there are two ways to obtain a gebo server...

1. Clone it

If you want to experiment or better understand gebo's inner workings, this is the option for you:

git clone
cd gebo-server

Once downloaded, install your npm modules:

sudo npm install

Then, install your UI dependencies:

bower install

2. Get it with npm

The gebo server offers all of the basic functionality expected of a communicative artificial agent. Your gebo's behaviour may be modified or supplemented without messing around with his basic skill set (yes, I said his).

This will get you up and running in no time:

mkdir myGebo
cd myGebo
npm init

Follow npm's setup instructions and then:

sudo npm install gebo-server --save


your SSL certificates

There are a couple of files already set up, but it's best that you create your own self-signed certificate:

cd cert
rm *
openssl genrsa -out key.pem
openssl req -new -key key.pem -out csr.pem
openssl x509 -req -days 9999 -in csr.pem -signkey key.pem -out cert.pem
rm csr.pem
cd ..

Seed the database

You may need to install grunt-cli first:

sudo npm install -g grunt-cli

This inserts a couple of test users into your database to confirm that authentication is working.

grunt dbseed

When you want to start adding your own users, you can erase the existing database like this:

grunt dbdrop

Run your server

node app.js


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using grunt.



npm loves you