gwatch 0.0.11

G-Watch is a toolbox for GPU profiling and program analysis.

G-Watch

G-Watch is a toolbox for agentic GPU kernel optimization. It features rich Profiling capabilities on both NVIDIA and AMD GPUs. Additionally, G-Watch offers Program Analysis tools for inspecting compiler-generated GPU binaries, facilitating secondary development tasks such as register analysis and binary instrumentation.

⚙️ Build and Installation

Option 1. Direct Install

You can install G-Watch directly from PyPI:

# install gwatch
pip install gwatch

# install gwatch skills for codex/claude/gemini-cli
gwatch install_skill

Option 2. Build from Source with Conda

You can set up the development environment directly on your host machine using Conda.

1. Clone this repository

   git clone --recursive https://github.com/mars-compute-ai/G-Watch-dev.git
   cd G-Watch-dev
   

2. Create and activate a conda environment

   conda create -n gw312 python=3.12 gcc_linux-64=13 gxx_linux-64=13 sysroot_linux-64=2.34 -c conda-forge
   conda activate gw312
   

3. Install system dependencies and build tools via Conda

   conda install -c conda-forge gcc_linux-64 gxx_linux-64 cmake make meson pkg-config \
       eigen elfutils libwebsockets libprotobuf=4.25.1 protobuf=4.25.1 libcurl openssl libdwarf \
       sqlite nlohmann_json pybind11_json pybind11 yaml-cpp
   
   cd $CONDA_PREFIX/lib/
   ln -sf libprotobuf.so.25.1.0 libprotobuf.so.25
   

4. Install Python dependencies

   pip3 install pytest perfetto PyYAML tqdm packaging loguru PrettyTable matplotlib pandas ninja==1.11.1.3
   pip3 install torch torchvision torchaudio
   

5. Build and install python package from source

   # export conda environment variables for linking
   export LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LIBRARY_PATH
   
   # build and install gwatch
   python3 setup.py clean  
   python3 setup.py bdist_wheel
   pip3 install dist/gwatch*.whl
   
   # install gwatch skills for codex/claude/gemini-cli
   gwatch install_skill
   

📃 Usage

In your Code Agent, use G-Watch skills, and run