Skip to content
Simple web browser to visualize HiC tracks
JavaScript CSS Python HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
example_browser fix typo Nov 3, 2016
hicbrowser fixed problem with chromosome names having "-" character Nov 6, 2017
.gitignore expanded documentation Aug 5, 2016
LICENSE Initial commit Nov 5, 2015
browserConfig.ini Added option to set a different index.html template using the --htmlF… Oct 7, 2016
gene_tracks.ini expanded documentation Aug 5, 2016
region_tracks.ini updated to add hicexplorer dependency Oct 26, 2017

HiCBrowser : A simple web browser to visualize Hi-C and other genomic tracks

Fidel Ramirez, José Villaveces, Vivek Bhardwaj


You can install HiCBrowser using pip :

pip install git+

You can also download/clone this GitHub repository and run the script inside :

cd HiCBrowser
python install -f

If you have Docker installed on your computer you can also use our Docker HiCBrowser Image. You can start a production ready HiCBrowser instance with:

docker run --rm -i -t -p 80:80 bgruening/docker-hicbrowser

For more information about the Docker image please refer to


Install HiCExplorer

HiCBrowser works using HiCExplorer in the background. Thus, you need to install HiCExplorer first.

If HiCExplorer and or HiCBrowser is not properly installed (by running it may be required to set the $PYTHONPATH. Specially for development it is quite convenient not to install the packages:

export PYTHONPATH=/path/to/HiCExplorer:/path/to/HiCBrowser

Test run

The folder example_browser contains all data and config files to run the browser. This is Drosophila melanogaster data only for chromosome X. To start the example server simply type:

cd example_browser

Prepare files

HiCBrowser needs three config files.

  • region tracks : To visualize all genomic tracks for given regions. (eg. gene_tracks.ini)
  • gene tracks : To visualize TADs near given gene. (eg. region_tracks.ini)
  • browser config file : To providing information about directories to save images and the two tracks above. (eg. browserConfig.ini)

We have provided example for each of these files with the package, as shown above. For a full documentation of what types of data can be plotted in the region tracks and for extended examples please look at the documentation of the plotTADs function of HiCExplorer


To run the browser, simply run runBrowser command, as shown below.

# --config = browser config file
# --port = localhost port to run the server

runBrowser --config browserConfig.ini --port 8888 --numProcessors 10 


Contact our google Group for further help with HiCBrowser or HiCExplorer.

You can’t perform that action at this time.