cogmission / nupic.studio Goto Github PK

NuPIC Studio is an all­-in-­one tool that allows users create a HTM neural network from scratch, train it, collect statistics, and share it among the members of the community. It is not just a visualization tool but an HTM builder, debugger and laboratory for experiments. It is ideal for newbies with little intimacy with NuPIC code as well as experts that wish a better productivity. Among its features and advantages:

• Users can open, save, or change their "HTM projects" or of other developers. A typical project contains data to be trained, neural network configuration, statistics, etc, which can be shared to be analysed or integrated with other projects.
• The HTM engine is the own original NuPIC libray (Python distribution). This means no port, no bindings, no re-implementation, etc. So any changes in the original nupic source can be immediatedly viewed. This helps users that wish test improvements like new encoders or even hierarchy, attention, and motor integration.

For more information, see numenta.org or the NuPIC Studio wiki.

Currently supported platforms:

• Linux (32/64bit)
• Mac OSX

Dependencies:

• 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 already are automatically installed by PIP package. However some errors might happen due to package conflicts specific of each system environment. In this case, you will have install manually these packages using a package manager like apt, yum, brew, etc.

If you want only 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. Doing this, you may need to add this location to your PATH and PYTHONPATH. Alternatively, you can run pip with 'sudo'.

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

nustudio

and then click on Open Project button to open any example to getting started with NuPIC.

If you want develop, debug, or simply test NuPIC Studio, clone it and follow the instructions:

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

The following instructions will work in the most Python IDEs:

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

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