commit 4b8fea60d25d3ee8e865a8091f7aaf5356721a4a
from: espejo got <noreply@nezzontli.xyz>
date: Fri May 22 00:47:02 2026 UTC

README legible (generado automáticamente desde README.md; no está en el repo original)

commit - d8f81a958823be18f5a064e355e037cfb4c128ef
commit + 4b8fea60d25d3ee8e865a8091f7aaf5356721a4a
blob - /dev/null
blob + ffc559fe3ca5cfe4fc5a5abd690da30a3b6840f8 (mode 644)
--- /dev/null
+++ README.txt
@@ -0,0 +1,185 @@
+guix-channel
+
+Canal personal de GNU Guix para el Nitro 5	Richard Bernal Estrada.
+
+Canal con paquetes binarios y configuracin de sistema para el Acer Nitro
+5 (Intel UHD 630 + GTX 1050 Max-Q, PRIME Render Offload, KDE Plasma).
+
+
+
+Estructura
+----------
+
+   guix-channel/
+	.forgejo/workflows/
+	   audit.yml		CI: verificacin esttica automtica
+	richard/
+	   packages/
+	      zen-browser.scm  Zen Browser 1.12.9b (binary wrap)
+	      mullvad.scm      Mullvad VPN 2026.1 (binary wrap desde .deb)
+	   services/
+	       mullvad.scm	Servicio Shepherd para mullvad-daemon
+	scripts/
+	   audit.py		Script de verificacin esttica (58 checks)
+	system/
+	    channels.scm	 Canales: guix + nonguix + este canal
+	    config.scm		 Configuracin del sistema (/etc/config.scm)
+	    home.scm		 Guix Home: GPG, YubiKey, bash
+
+
+
+Agregar el canal
+----------------
+
+Aade esto a ~/.config/guix/channels.scm:
+
+   (channel
+	 (name 'richard)
+	 (url "https://codeberg.org/Richard7987/guix-channel")
+	 (branch "main")
+	 (introduction
+	   (make-channel-introduction
+	     "17ca291dac7ec48ce8266b3726d1fdcc513e99f7"
+	     (openpgp-fingerprint
+	       "91CA 581F 7B78 01E8 8673  D228 DBD5 F61D 8A0A 14D7"))))
+
+Luego:
+
+   guix pull
+   guix install zen-browser	 # o mullvad-vpn
+
+
+
+Instalar el sistema completo (Nitro 5)
+--------------------------------------
+
+   # 1. Clonar el repo
+   git clone git@codeberg.org:Richard7987/guix-channel.git ~/guix-channel
+
+   # 2. Copiar configuraciones
+   sudo cp ~/guix-channel/system/config.scm /etc/config.scm
+   mkdir -p ~/.config/guix
+   cp ~/guix-channel/system/channels.scm ~/.config/guix/channels.scm
+
+   # 3. Actualizar canales y reconfigurar
+   guix pull
+   sudo guix system reconfigure /etc/config.scm
+
+   # 4. Aplicar configuracin de usuario (Guix Home)
+   guix home reconfigure ~/guix-channel/system/home.scm
+
+
+
+Paquetes incluidos
+------------------
+
+Zen Browser (zen-browser)
+-------------------------
+
+Fork de Firefox enfocado en privacidad con barra lateral y espacios de
+trabajo. Empaquetado como binary wrap desde el tarball oficial de GitHub.
+
+   guix install zen-browser
+
+Para actualizar a una versin nueva:
+
+   # 1. Editar richard/packages/zen-browser.scm  cambiar 'version'
+   # 2. Obtener el hash nuevo:
+   guix download https://github.com/zen-browser/desktop/releases/download/VERSION/zen.linux-x86_64.tar.xz
+   # 3. Reemplazar el (base32 "...") con el hash obtenido
+   git commit -am "zen-browser: actualizar a VERSION"
+   git push
+
+Mullvad VPN (mullvad-vpn + servicio Shepherd)
+---------------------------------------------
+
+Cliente VPN centrado en privacidad. Incluye daemon (mullvad-daemon) y CLI (mullvad).
+El daemon arranca automticamente con el sistema.
+
+   # Tras instalar el sistema, activar la cuenta:
+   mullvad account login TU_NUMERO_DE_CUENTA
+
+   # Conectar
+   mullvad relay set location mx   # servidores en Mxico
+   mullvad connect
+
+   # Estado
+   mullvad status
+   herd status mullvad
+
+Para actualizar:
+
+   # 1. Editar richard/packages/mullvad.scm	 cambiar 'version'
+   # 2. Obtener el hash:
+   wget https://github.com/mullvad/mullvadvpn-app/releases/download/VERSION/MullvadVPN-VERSION_amd64.deb
+   sha256sum MullvadVPN-VERSION_amd64.deb | python3 scripts/nix32.py
+   # 3. Reemplazar el (base32 "...") con el resultado
+
+
+
+Hardware objetivo
+-----------------
+
+Componente	Detalle
+
+Laptop	Acer Nitro 5
+CPU		Intel Coffee Lake-H
+iGPU	Intel UHD 630 (PCI:0:2:0)
+dGPU	NVIDIA GTX 1050 3 GB Max-Q (PCI:1:0:0)
+GPU Mode	PRIME Render Offload (sin MUX switch)
+DE		KDE Plasma 6 + SDDM
+Kernel	Linux no-libre (nonguix)
+
+Verificar PRIME tras instalar
+-----------------------------
+
+   # Debe mostrar Intel/Mesa
+   glxinfo | grep "OpenGL renderer"
+
+   # Debe mostrar NVIDIA GTX 1050
+   __NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia \
+	 glxinfo | grep "OpenGL renderer"
+
+   # Lanzar Blender con NVIDIA
+   __NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia blender
+
+
+
+Versionado
+----------
+
+Este proyecto usa CalVer (YYYY.N):
+
+Versin  Fecha      Cambios
+
+v2026.1   Mayo 2026	 Versin inicial: KDE Plasma, PRIME Offload, Mullvad, Zen Browser, YubiKey
+
+Para crear un nuevo release en Codeberg:
+
+   git tag v2026.2
+   git push origin v2026.2
+
+
+
+CI  Verificacin esttica
+-----------------------
+
+El script scripts/audit.py corre 58 checks automticos en cada push:
+
+   Validez de hashes nix32 (formato y longitud)
+   Imports de mdulos requeridos en todos los archivos .scm
+   Presencia de servicios crticos (nvidia-service-type,
+	sddm-service-type, etc.)
+   Configuracin PRIME (BusID, AllowNVIDIAGPUScreens, nvda)
+   Paquetes requeridos en el sistema
+   Configuracin de Guix Home (GPG, YubiKey, pinentry)
+
+   # Correr localmente
+   python3 scripts/audit.py
+
+
+
+Licencia
+--------
+
+GPL-3.0  ver LICENSE LICENSE