Installation#

Requirements#

HBAT requires:

  • Python: 3.9 or higher

  • tkinter: Included with Python standard library on most systems. On macOS, install Python and tkinter using Homebrew:

brew install python python3-tk
  • GraphViz (Optional): Required for advanced cooperativity chain visualization with high-quality graph rendering. HBAT will automatically fall back to NetworkX/matplotlib visualization if GraphViz is not available.

GraphViz Installation#

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install graphviz

macOS (using Homebrew):

brew install graphviz

Windows:

  • Download and install from GraphViz official website

  • Or using Chocolatey: choco install graphviz

  • Or using conda: conda install -c conda-forge graphviz

Note

After installing GraphViz, restart your terminal/command prompt before running HBAT to ensure the GraphViz executables are available in your PATH.

Installation Methods#

From PyPI#

pip install hbat

Run HBAT Command-Line Interface (CLI) using hbat or launch HBAT GUI using hbat-gui.

From Github#

pip install git+https://github.com/abhishektiwari/hbat.git

From Source#

git clone https://github.com/abhishektiwari/hbat.git
cd hbat
pip install -e .

From Conda#

conda install -c hbat hbat

Verification#

To verify the installation:

hbat --version

Or test the command line interface:

hbat --help