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!
Installing
Nutella is written in ruby but it leverages a bunch of other technologies that need to be installed. You will need:
- ruby (version >= 2.1.0). Do yourself a favor and use RVM to install Ruby.
- git (version >= 1.8.0). Do yourself a favor and use Homebrew to install git, if you are on OSX.
- tmux (version >= 1.8.0). Do yourself a favor and use Homebrew to install tmux, if you are on OSX.
- Docker (version >= 17.03.0). We use Docker to run the broker that handles all communications between all the pieces of the framework. Do yourself a favor and use Docker for mac, if you are on OSX.
-
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.
nutella checkup
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!
Where next?
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.
Building (for contributors)
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.