# Grano User Interface
[grano](http://grano.cc/) is a toolkit for building journalistic social network analysis applications on the web. This package contains an administrative user interface based on [AngularJS](http://angularjs.org/). The interface is intended for managing entities and analysis for advanced users, not as a general-purpose interface.
## Installation
grano-ui
requires that you have installed and configured [grano](http://grano.cc/). Please refer to [grano's documentation](http://docs.grano.cc/) for further instructions. You'll also need to install these external (non-Python dependencies):
- Twitter's [bower](https://github.com/bower/bower) for installing JS dependencies.
- [UglifyJS](https://github.com/mishoo/UglifyJS/) for JS minification.
- [Less](http://lesscss.org/) for compiling the CSS resources.
To install the package from GitHub, you need to follow these steps from within the virtual environment in which grano
has been installed:
`bash
git clone https://github.com/granoproject/grano-ui.git
cd [grano dir]
virtualenv env
source env/bin/activate
cd [grano-ui dir]
python setup.py develop
bower install (in docker, use --allow-root or su app -c "bower install")
`
After installing the package, you will still need to enable this plugin. Add the entry ui
to the PLUGINS
variable in your grano settings file. If you have no other plugins installed, try this:
`python
PLUGINS = ['ui']
`
## Configuration
By default, grano-ui
will deploy itself to the web root of grano
when it has been activated as a plugin. You can change that path by setting a UI_PREFIX
, starting with a forward slash.
`python
UI_PREFIX = '/grano'
`
Further, asset compilation and minification can be enabled by setting the ASSETS_DEBUG
variable to False
.