🚀 BangtrixToolkit

Essential Custom Nodes for ComfyUI

A powerful toolkit for ComfyUI featuring a real-time Hardware Monitor overlay with native AMD/NVIDIA GPU/APU support, and a Universal Prompt Translator node — all in one clean package.

---

✨ Key Features (Click to Collapse)

🖥️ Advanced HW Monitor

A real-time monitoring overlay displayed directly on the ComfyUI canvas. Tracks GPU Name, Load (%), VRAM Usage, Temperature (°C), and Fan Speed (%) with animated progress bars and a live sparkline graph. The widget is fully draggable, minimizable, and toggleable via Ctrl + Shift + M.

🔥 New Quality of Life Additions:

• 🧹 One-Click Memory Flush: Instantly free up VRAM and System RAM directly from the overlay using the clear button. It safely unloads all idle models, clears the PyTorch cache, and triggers Python garbage collection—saving you from Out of Memory (OOM) errors before running heavy upscale workflows.
• ⚡ Smart ROCm Smoothing: Uses an ultra-responsive 500ms polling rate coupled with a custom "Peak Hold / Max Aggregate" algorithm. This ensures accurate tracking of bursty AI compute workloads across all GPU engines, completely eliminating the inaccurate "0% usage drops" commonly seen in standard Windows Task Manager monitoring.

🔌 Native AMD ROCm Support

An intelligent multi-backend architecture automatically detects your GPU vendor and selects the optimal data source.

GPU	Platform	Primary Backend	Fallback
AMD RDNA3 (RX 7000+)	Windows	ROCm / HIP SDK (hipInfo.exe) + PDH	PowerShell / WMI
Legacy AMD	Windows	ADL (atiadlxx.dll) + PDH	PowerShell
NVIDIA	Windows / Linux	NVML / nvidia-smi	PDH / sysfs
Intel ARC / iGPU	Windows / Linux	PDH + sysfs	PowerShell / hwmon

No third-party background applications are required — the backend relies only on native OS tools and your existing AMD driver stack.

🌐 Universal Prompt Translator

An integrated translation node that converts prompts from 16+ languages into English and directly outputs CLIP conditioning.

Code	Language	Code	Language
auto	Auto Detect	en	English
id	Indonesian	ja	Japanese
ko	Korean	zh-CN	Chinese (Simplified)
zh-TW	Chinese (Traditional)	fr	French
de	German	es	Spanish
pt	Portuguese	ru	Russian
it	Italian	ar	Arabic
tr	Turkish	hi	Hindi
th	Thai	vi	Vietnamese

✨ Sample Translation

Indonesian Input	Final English Prompt
wanita cantik memakai kimono di malam hari	beautiful woman wearing kimono at night, cinematic lighting, high quality, detailed

🎛️ Presets

Quality	Style	Auto Negative
normal — Standard	none — No style	normal — Basic
high — Enhanced details	anime · realistic · cinematic	strong — Reduced artifacts
ultra — Maximum quality	photography · product · fantasy · portrait	ultra — Maximum cleanup

💡 Tips: Use show_original to debug translations · Enable enable_cache for faster workflows · Use ultra quality for SDXL and Flux · Use the anime preset for anime models · Use realistic or photography for realism-based models

📸 Sample Workflow

---

⚙️ Customization UI & Settings (Click to Expand)

The HW Monitor integrates directly into the ComfyUI Settings panel. All changes are applied instantly — no browser reload required.

Setting	Type	Options
🌗 Base Mode	Combo	Dark · Light
🎨 Theme	Combo	Default Green · Neon Blue · Crimson Red · Hacker (Black & Green) · Custom Colors
⏱️ Refresh Rate	Combo	500ms · 1s · 2s
👁️ Show on Startup	Boolean	On / Off
🔲 Background Opacity	Slider	0.1 – 1.0 (step 0.05)
📦 Compact Mode	Boolean	Hides sparkline graph for minimal footprint
👻 Ghost Mode	Boolean	Makes the background completely invisible/transparent

Access the settings by clicking the ⚙ gear icon on the HW Monitor widget header.

🎨 Theme Samples

⌨️ Keyboard Shortcuts & Actions

Action	Control
Show / Hide Overlay	Ctrl + Shift + M
Minimize Widget	Click − button
Open Settings	Click ⚙ button
Flush VRAM & RAM	Click 🧹 Clear button
Reposition Widget	Drag the header bar

---

🚀 Installation Guide (Click to Expand)

🔧 Manual Installation

cd ComfyUI/custom_nodes
git clone [https://github.com/Anonymzx/BangtrixToolkit.git](https://github.com/Anonymzx/BangtrixToolkit.git)
pip install -r BangtrixToolkit/requirements.txt

📥 Via ComfyUI Manager (Recommended)

1. Open ComfyUI Manager inside ComfyUI
2. Go to the Custom Nodes Manager tab
3. Search for BangtrixToolkit
4. Click Install
5. Restart ComfyUI

After restarting, the HW Monitor overlay will appear automatically — no additional node configuration is required.

---

⚠️ Compatibility, Testing & Bug Reports (Click to Expand)

🧪 Tested explicitly on: AMD Radeon™ RX 7800 XT (RDNA3), AMD Ryzen™ APUs

🤝 Call for Feedback (NVIDIA, Intel & Other AMD GPUs): Since this toolkit was developed and explicitly tested on the specific AMD hardware above, the integrations for NVIDIA, Intel, and other AMD GPUs (like RDNA2, Vega, Polaris) are implemented based on official APIs (NVML, sysfs, PDH, ADL).

If you are using an NVIDIA GPU, an Intel ARC/iGPU, or other AMD GPUs and encounter any issues (such as N/A values, missing sensors, or graphical glitches), please open an issue on GitHub. Kindly include:

A screenshot of the HW Monitor overlay.

Your ComfyUI terminal log (showing the backend initialization). Your feedback is highly appreciated to help patch and perfect the monitoring experience for everyone!

---

Why install AMD ROCm / HIP SDK?

Windows restricts direct access to temperature and fan speed sensors on most AMD GPUs. To allow the HW Monitor to extract these values natively without relying on bloated third-party background apps, installing the AMD ROCm / HIP SDK is highly recommended for the general AMD ecosystem.

📥 Download: AMD ROCm HIP SDK

After installation, the backend will automatically detect hipInfo.exe and amd-smi through the HIP_PATH environment variable and combine it with live Windows PDH data.

---

🚨 Current RDNA3 (RX 7000 Series) Limitation:

While the ROCm backend works flawlessly for extracting advanced metrics, please note that as of the current Windows drivers, AMD's RDNA3 architecture strictly locks thermal extraction via native APIs.

If you are using an RX 7000 series GPU, you will reliably get GPU Name, GPU Load, and VRAM Usage, but thermal sensors (Temp/Fan) will temporarily output N/A even with ROCm installed.

We have integrated the native ROCm backend to future-proof your setup. Once AMD releases a driver patch that unlocks this API for Windows, your Temp and Fan readings will automatically spring to life without needing to update this node!

💖 Support This Project

If you find this toolkit useful and it improves your ComfyUI workflow, consider supporting its development!

❤️ Created by Anonymzx