Skip to content

Installing and Building

DavidRagazzi edited this page Sep 16, 2014 · 11 revisions

This chapter aims to help you with build and installation issues.

Installation

NuStudio is currently supported for the following platforms:

  • Linux (32/64bit)
  • Mac OSX

Its dependencies include:

  • Python (2.7 or later) (with development headers)
  • PIP
  • Nupic
  • NumPy & SciPy
  • PyOpenGL & PyOpenGL-accelerate
  • PyQt4 & PyQtGraph

Note: Except Python, PIP and NuPIC, all dependencies above are already automatically installed by PIP package. However some packages like SciPy and PyQt4 might present errors due to conflicts specific to each system environment. In this case, you will have to install these packages manually using a package manager like apt, yum, or brew:

apt-get install python-scipy
yum install scipy
brew install scipy

apt-get install python-qt4
yum install PyQt4
brew install pyqt

User Instructions

If you only want to use it, simply do this:

pip install nustudio

Note: If you get a "permission denied" error when using pip, you may add the --user flag to install to a location in your home directory, which should resolve any permissions issues. If you do this, you may need to add this location to your PATH and PYTHONPATH. Alternatively, run pip with 'sudo'.

Once it is installed, you can execute the app using:

nustudio

Developer Instructions

If you want to develop, debug, or simply test NuPIC Studio, clone it and follow (one set of) these instructions:

Using the command line

This assumes the NUPIC_STUDIO environment variable is set to the directory where the NuPIC Studio source code exists.

cd $NUPIC_STUDIO
python setup.py build
python setup.py develop

Using an IDE

The following instructions will work in most Python IDEs:

  • Open your IDE.
  • Open a project specifying the $NUPIC_STUDIO repository folder as location.
  • Click with the right mouse button on the setup.py file listed under project files and select the Run command on the pop-up menu. This will call the build process. Check the output panel to see the result.
  • If the build was successful, just click on program.py and voilà !

If you don't have a favorite Python IDE, this article can help you to choose one: http://pedrokroger.net/choosing-best-python-ide/

Clone this wiki locally