Install

pip install gdbgui

# create isolated environment  
python3 -m venv ~/gdbgui-env  
  
# activate it  
source ~/gdbgui-env/bin/activate  
  
# upgrade pip  
pip install --upgrade pip  
  
# install gdbgui (fresh, compatible deps)  
pip install gdbgui  
  
# run it (WITH threading mode to avoid eventlet)  
gdbgui ./binary

Usage

source ~/gdbgui-env/bin/activate

# -------------------------  
# RUN GDBGUI  
# -------------------------  
gdbgui ./binary  
  
# -------------------------  
# ACCESS UI  
# -------------------------  
# Open browser:  
http://127.0.0.1:5000  
  
# -------------------------  
# IMPORTANT (WITH GEF)  
# -------------------------  
# Run WITHOUT loading GEF (recommended)  
gdbgui --gdb-cmd "gdb -nx" ./binary  
  
# (-nx = ignore ~/.gdbinit → disables GEF)  
  
# -------------------------  
# BASIC USAGE IN UI  
# -------------------------  
# In browser:  
# - Click "Run" → start program  
# - Click line numbers → set breakpoints  
# - Step / Next → execution control  
# - View registers / stack panels  
  
# -------------------------  
# OPTIONAL FLAGS  
# -------------------------  
# Change port  
gdbgui -p 8080 ./binary  
  
# Listen on all interfaces  
gdbgui --host 0.0.0.0 ./binary