nanokvm usb

AGENTS.md

@@ -695,7 +695,8 @@ uses dedicated NixOS partitions, LUKS, Secure Boot, and TPM-backed disk unlock.
 It selects `workload.photography` for AI-enabled darktable. The application
 chooses CUDA support from the NVIDIA hardware unit's enable state and keeps
 the default CUDA targets, including RTX 3060 Ti support, to reuse binary caches.
-galleria and x1g13 select `workload.network-lab` for containerlab and Docker.
+galleria and x1g13 select `workload.network-lab` for containerlab, Docker, and
+the NanoKVM-USB desktop client with serial-port access.
 m2 is the daily-use macOS development and personal machine with the macOS
 interface defaults. Keep the desktop sessions independently selectable, and
 keep the development and personal profiles usable across NixOS and Darwin.

modules/applications/nanokvm-usb/meta.nix

@@ -0,0 +1,5 @@
+{
+  description = "Sipeed NanoKVM-USB desktop client";
+
+  includes = [ "services.nanokvm-usb" ];
+}

modules/applications/nanokvm-usb/nixos.nix

@@ -0,0 +1,23 @@
+{ pkgs, ... }:
+let
+  nanokvm-usb = pkgs.appimageTools.wrapType2 rec {
+    pname = "nanokvm-usb";
+    version = "1.1.4";
+
+    src = pkgs.fetchurl {
+      url = "https://github.com/sipeed/NanoKVM-USB/releases/download/v${version}/NanoKVM-USB-${version}-linux-x86_64.AppImage";
+      hash = "sha256-00MT4U2afv0qt3xFVhLr0SSmS2cLrKBlmfzqYEFuaVc=";
+    };
+
+    meta = {
+      description = "Sipeed NanoKVM-USB desktop client";
+      homepage = "https://github.com/sipeed/NanoKVM-USB";
+      license = pkgs.lib.licenses.gpl3Only;
+      platforms = [ "x86_64-linux" ];
+      mainProgram = "nanokvm-usb";
+    };
+  };
+in
+{
+  environment.systemPackages = [ nanokvm-usb ];
+}

modules/profiles/README.md

@@ -75,8 +75,9 @@ Neovim, Yazi, and the remaining interactive command-line tools.
 `workload.machine-learning` provides the Hugging Face Hub CLI for hosts used
 to download and publish machine learning models and datasets.
 
-`workload.network-lab` provides containerlab using its upstream NixOS module
-and the Docker service. It is selected by galleria and x1g13.
+`workload.network-lab` provides containerlab using its upstream NixOS module,
+the Docker service, and the NanoKVM-USB desktop client with serial-port access.
+It is selected by galleria and x1g13.
 
 `workload.photography` provides darktable with AI support from the locked
 unstable package set. Its ONNX Runtime uses CUDA when the NVIDIA hardware unit

modules/profiles/workload/network-lab/meta.nix

@@ -1,5 +1,8 @@
 {
-  description = "Container-based network lab environment";
+  description = "Network lab and hardware console environment";
 
-  includes = [ "applications.containerlab" ];
+  includes = [
+    "applications.containerlab"
+    "applications.nanokvm-usb"
+  ];
 }

modules/services/nanokvm-usb/nixos.nix

@@ -0,0 +1,4 @@
+{ primaryUser, ... }:
+{
+  users.users.${primaryUser}.extraGroups = [ "dialout" ];
+}