- VIGIL là TUI mã nguồn mở của GIN-SYSTEMS (v1.0.0, 19/04/2026) đọc cảm biến phần cứng để hiển thị watt, nhiệt độ, xung nhịp và chi phí điện theo thời gian thực — không cần trình duyệt, không background service, không telemetry.
TL;DR
VIGIL là terminal dashboard viết bằng Python + Textual, đọc trực tiếp cảm biến phần cứng để hiện watt tiêu thụ, nhiệt độ, xung nhịp và điểm hiệu suất của CPU / GPU / RAM theo thời gian thực. Kèm bảng xếp hạng tiến trình theo watt, biểu đồ braille, webhook cảnh báo, log JSONL, và bộ tính tiền điện theo giờ/ngày/session. MIT license, chạy trên Linux, Windows, macOS. v1.0.0 vừa phát hành 19/04/2026.
Có gì mới
Khác với htop, btop hay nvtop chủ yếu đo % CPU/GPU, VIGIL tập trung vào thứ mà hầu hết monitor bỏ qua: điện năng thực tế và chi phí tương ứng. Một lệnh vigil mở full dashboard; lần đầu chạy có wizard hỏi TDP CPU/GPU và giá điện (per kWh) để dựng mô hình chi phí.
- Watt theo thời gian thực cho CPU (hwmon / RAPL / LibreHardwareMonitor), GPU (NVIDIA NVML), RAM (modeled).
- Xếp hạng tiến trình theo watt dựa trên share CPU% của từng PID, kèm sparkline xu hướng.
- Tính tiền điện: /hr, /day, session total với ký hiệu tiền tệ tuỳ chỉnh.
- Baseline mode: snapshot trạng thái idle để so delta khi chạy workload thật.
- Alert + log: webhook HTTP POST khi vượt ngưỡng + JSONL session log để pipe vào Grafana/Loki.
- Export SVG một phím bấm (
s) — tiện cho bug report hoặc blog post. - Hai theme: TacticalCyberpunk (tối) và GhostWhite (sáng), đổi màu live không cần restart.
Vì sao đáng quan tâm
Với workload AI / rendering / gaming chạy 24/7, điện năng là chi phí thật — một GPU 300W chạy liên tục 24 giờ với giá 3.000đ/kWh tốn hơn 200.000đ/ngày. Nhưng hầu hết công cụ hiện có chỉ cho bạn xem utilization %, không phải watt và càng không phải tiền. VIGIL điền vào khoảng trống đó với một binary duy nhất, không server, không dashboard web, không tài khoản.
Với laptop chạy pin, tính năng process wattage ranking đặc biệt hữu ích: bạn thấy ngay Chrome hoặc một plugin background đang ngốn bao nhiêu watt — thứ mà Task Manager của Windows hay Activity Monitor của macOS chỉ hiện dưới dạng mơ hồ.
Chi tiết kỹ thuật
| Hạng mục | Giá trị |
|---|---|
| Ngôn ngữ | Python 3.11+ |
| Framework TUI | Textual ≥ 0.80 |
| Thư viện phần cứng | psutil ≥ 5.9.8, pynvml ≥ 11.5.0 |
| Windows extras | wmi ≥ 1.5.1, pywin32 ≥ 306 (qua LibreHardwareMonitor) |
| TDP mặc định | CPU 65 W, GPU 165 W (chỉnh trong ~/.config/vigil/config.toml) |
| Công thức chi phí | (watt ÷ 1000) × kwh_price × thời_gian |
| License | MIT |
| Version | v1.0.0 — 19/04/2026 |
Efficiency score được gắn nhãn OPTIMAL / NORMAL / LOW EFF / THROTTLE; khi CPU bị throttle nhiệt, badge nháy đỏ rõ trong dashboard để dễ nhận.
So với tool cùng loại
| Tool | CPU watt | GPU watt | Watt / process | Tiền điện | Đa nền tảng |
|---|---|---|---|---|---|
| VIGIL | ✅ hwmon/RAPL/LHM | ✅ NVML | ✅ | ✅ /hr /day total | Linux / Win / macOS |
| s-tui | ✅ (RAPL) | ❌ | ❌ | ❌ | Linux |
| btop | ❌ (chỉ %) | Một phần | ❌ | ❌ | Đa nền tảng |
| picomon | ❌ | ✅ (AMD/NV/Apple) | ❌ | ❌ | Đa nền tảng |
| nvtop | ❌ | ✅ NV | ❌ | ❌ | Linux |
Điểm khác biệt của VIGIL nằm ở tổ hợp bốn thứ ít tool nào gộp cùng lúc: watt per-process, chi phí tiền điện, baseline delta, và webhook + JSONL logging sẵn có.
Ai sẽ dùng
- Home lab / workstation: track watt thật của render/training, hiểu hoá đơn điện đến từ đâu.
- Laptop trên pin: soi process nào âm thầm ăn watt, tắt ngay.
- Dân overclock / tuner: nhìn frequency + throttle event + efficiency score khi tinh chỉnh power limit.
- SRE trên bare metal: bật JSONL log + webhook → pipe vào Grafana hoặc PagerDuty.
- Giáo viên / demo năng lượng: chi phí /giờ hiển thị trực tiếp, dễ giải thích.
Giới hạn & giá
- Miễn phí, MIT license, không tier trả phí.
- macOS: CPU power chỉ là estimate (không có API userspace đo trực tiếp); Apple Silicon GPU power chưa hỗ trợ.
- GPU: hiện chỉ NVIDIA qua NVML — chưa có AMD hay Intel Arc first-class.
- Windows: cần cài LibreHardwareMonitor riêng để có watt CPU chính xác; nếu không sẽ fallback về estimate.
- RAM watt: được mô hình hoá, không đo trực tiếp — nên coi là chỉ số định hướng.
- Cài đặt: yêu cầu Python 3.11+; cài bằng
pip install .từ git clone (chưa có package trên PyPI ở v1.0.0).
Sắp tới
Repo mới ở 63 sao, 7 fork sau khi release vài ngày — quỹ đạo tăng nhanh. Dựa trên các giới hạn hiện tại, roadmap hợp lý sẽ là: GPU power cho AMD / Intel Arc, Apple Silicon power qua powermetrics, phân phối PyPI, và exporter Prometheus / OpenTelemetry cho use-case ops.
