Installation

Easy Installation

If you aren’t familiar at all with Python, please see Installing Python.

Installation is made easy with pip (or pip3), with releases as we have time while we try to create a full first release. Much of it works already, but we certainly need issue reports (on github).

To install tyoe:

pip install --user mousai

at your command prompt (not the python prompt) where --user isn’t necessary if you are using a locally installed version of Python such as Anaconda.

To run, I recommend you open a Jupyter notebook by using jupyter notebook and then type:

import mousai as ms

For examples, see the example ipynb notebooks. Some of these have interactive capabilities that are only apparent when you load them with Jupyter instead of just looking at them on github.

Installation of current development version

The usage documentation is far behind the current code, while the reference is way ahead of the released code due to the autodoc capability of Sphinx. Especially as of early 2017, the code is in rapid development. So is the documentation. Releases to pypi are far behind current status as stopping to deploy would cost more time that it is worth. We have the objective of releasing a first non-beta version at the end of May, but even this cannot be promised.

If you wish to stay current with the software, fork the repository, then clone it to your desktop.

Then, in the root directory of mousai, at the command prompt (not Python prompt) type:

pip install -e .

Now if sync/update your clone, you will have the current version each time you do so.

The added benefit is that you can also develop and contribute by submitting pull requests. Please don’t edit inside the mousai directories unless you intend to submit a pull request because your edits may be overwritten or lost.

That should be it. Please note issues on the issues tab on github.