commit - d8f81a958823be18f5a064e355e037cfb4c128ef
commit + 4b8fea60d25d3ee8e865a8091f7aaf5356721a4a
blob - /dev/null
blob + ffc559fe3ca5cfe4fc5a5abd690da30a3b6840f8 (mode 644)
--- /dev/null
+++ README.txt
+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
