Installation Guide

This guide will briefly explain how to install julia and Mimi.

Installing julia

Mimi requires the programming language julia to run. You can download the current release from the julia download page. You should download and install the command line version from that page.

Installing Mimi

Once julia is installed, start julia and you should see a julia command prompt. To install the Mimi package, issue the following command:

julia> Pkg.add("Mimi")

You only have to run this command once on your machine.

As Mimi gets improved we will release new versions of the package. To make sure you always have the latest version of Mimi installed, you can run the following command at the julia prompt:

julia> Pkg.update()

This will update all installed packages to their latest version (not just the Mimi package).

Using Mimi

When you start a new julia command prompt, Mimi is not yet loaded into that julia session. To load Mimi, issue the following command:

julia> using Mimi

You will have to run this command every time you want to use Mimi in julia. You would typically also add using Mimi to the top of any julia code file that for example defines Mimi components.

Editor support

There are various editors around that have julia support:

• IJulia adds julia support to the jupyter (formerly IPython) notebook system.
• Juno adds julia specific features to the Atom editor. It currently is the closest to a fully featured julia IDE.
• Sublime, VS Code, Emacs and many other editors all have julia extensions that add various levels of support for the julia language.

Getting started

The best way to get started with Mimi is to work through the Tutorials.

The Mimi github repository also has links to various models that are based on Mimi, and looking through their code can be instructive.

Finally, when in doubt, ask your question in the Mimi Framework forum or post an Issue to the Github repository if you have a specific request for the development team. Don't be shy about either option, we would much prefer to be inundated with lots of questions and help people out than people give up on Mimi!