nutella is a framework to build and run Macroworlds. It's still very under development so any help finding and fixing bugs will be greatly appreciated!

Nutella is written in ruby but it leverages a bunch of other technologies that need to be installed. You will need:

1. ruby (version >= 2.1.0). Do yourself a favor and use RVM to install Ruby.
2. git (version >= 1.8.0). Do yourself a favor and use Homebrew to install git, if you are on OSX.
3. tmux (version >= 1.8.0). Do yourself a favor and use Homebrew to install tmux, if you are on OSX.
4. node.js (version >= 0.10.0). Yes, really, you need to install node becaue we use it to run the broker that handles all communications between all the pieces of the framework. Do yourself a favor and use nvm.
5. mongoDB (optional). You'll need mongoDB if you want to use it with nutella.persist.

Once you have all of these, to install nutella simply do:

gem install nutella_framework

Once the installation is complete you should be able to type nutella in your shell and get a welcome message.

If you are reading this you probably already saw the warning: "Looks like this is a fresh installation of nutella. Please run 'nutella checkup' to check all dependencies are installed".

nutella is written in ruby but it's designed to run bots and interfaces written in virtually any programming language. All communications among these components are handled by an MQTT broker which needs to be installed (together with its dependencies) before nutella can actually work correctly. Therefore right after your install nutella you should run:

nutella checkup

This will install the Mosca MQTT broker and make sure all the dependencies required by nutella are installed as well.

Congratulations! nutella is ready to use!

If you already have an application you want to tinker with (like RoomQuake) simply checkout the application to a local folder, cd /to/my/local/folder and start tinkering away. Not sure how? Check out the man page for the nutella command line tool.

If you want to create your own application, hold on tight, a tutorial is coming soon.

Clone the repo, bundle install to take care of the dependencies and then rake to run all the tests. If you want to build and install the gem just rake install. If you want a list of available build tasks, simply type rake -T.