volta v0.1-alpha: Agent POC & Live CLI Dashboard

Summary

This release marks the completion of the Proof of Concept (POC) phase for the volta agent module. It introduces a functional, high-performance C++ monitoring daemon capable of detecting hardware and collecting system metrics in real-time.

The primary goal of this release is to demonstrate the stability of the data ingestion pipeline and the accuracy of hardware readings (CPU, RAM, GPU) without yet involving the network layer.

Key Features

• Real-Time Terminal Dashboard: A live, self-updating Text User Interface (TUI) displaying current system status directly in the console.
• Dynamic Hardware Detection:
  • Automatic OS and Kernel version detection (/etc/os-release).
  • CPU Vendor and Model parsing (/proc/cpuinfo).
  • NVIDIA GPU detection via runtime library check.
• Implemented Collectors:
  • CPU: Total usage calculation based on /proc/stat delta.
  • RAM: Precise memory usage (Total vs. Available) handling Linux caching quirks (/proc/meminfo).
  • NVIDIA GPU: Full integration with NVML for Power (W), Temperature (°C), Utilization (%), and VRAM usage.
• Architecture:
  • Modular Scheduler -> Collector design pattern.
  • Robust CMake build system with vcpkg integration (gRPC, Protobuf).
  • Vendored dependencies (nvml.h) for easier compilation on constrained systems.

Limitations (Alpha)

• Local Mode Only: This version runs in a standalone loop and does not yet transmit data via gRPC to a central server.
• Platform Support: Verified on Linux (Fedora/Debian/Ubuntu).

How to Build & Run

Ensure you have cmake, make, and a C++17 compiler installed.

# Clone and prepare build dir
mkdir build && cd build

# Configure CMake (replace [path_to_vcpkg] with your actual path!)
# Example: -DCMAKE_TOOLCHAIN_FILE=~/vcpkg/scripts/buildsystems/vcpkg.cmake
cmake .. -DCMAKE_TOOLCHAIN_FILE=[path_to_vcpkg]/scripts/buildsystems/vcpkg.cmake

# Compile sources
cmake --build .

# Run Agent
./source/agent/volta_agent

---

Contributors

@varev-dev