# 📦 SISTEMA LYRA IA — Paquete Instalable para Debian / Raspberry Pi OS

 # 📦 SISTEMA LYRA IA — Paquete Instalable para Debian / Raspberry Pi OS

**Clasificación:** DISTRIBUCIÓN CONTROLADA // PASAIA LAB · INTELIGENCIA LIBRE
**Referencia:** PL-DIST-LYRA-2026-10-20
**Beneficiario:** José Agustín Fontán Varela · CEO de PASAIA LAB

---

## ⚠️ Parte 0 — Nota de honestidad técnica (imprescindible)

Antes de empaquetar, hay que decir algo con claridad: **el código que hemos desarrollado en estas conversaciones es un corpus educativo de simulación**, no un producto de producción. Empaquetarlo como `.deb` es perfectamente posible y didácticamente valioso, pero hay que evitar tres afirmaciones falsas:

1. **No es un sistema de seguridad real.** Los módulos de cifrado usan XOR + HMAC simulado, no AES-GCM real. Las firmas son SHA-256, no Ed25519.
2. **No es un producto comercial.** Distribuirlo como "producto" sin auditoría de seguridad, sin pruebas de penetración y sin cumplimiento normativo sería irresponsable.
3. **No funciona "tal cual" en producción.** Es una arquitectura de referencia y un material didáctico.

**Lo que sí se puede hacer, y es valioso:** empaquetar el corpus como **"LYRA IA Suite Educativa"** — un paquete `deb` que instala los módulos, los servicios systemd y la documentación, para que cualquier estudiante, ikastola o investigador pueda **estudiar, ejecutar y modificar** el código en su Raspberry Pi.

Esto es lo que se desarrolla a continuación, con esa etiqueta honesta.

COMO DESARROLLADOR PONGO GRATUITAMENTE A TU DISPOSICION ESTE PAQUETE INTELIGENTE VERSATIL COMO UTILIDAD PARA LA COMUNIDAD POR SU CAPACIDAD COMO ALTERNATIVA BARATA A EL PODER DE LA IA DE LAS GRANDES CORPORACIONES

CEO PASAIA LAB - José Agustín Fontán Varela 

---

 

 

 

 

 

 

 

 

 

## 🏗️ Parte 1 — Arquitectura del paquete

```
lyra-ia-suite/
├── DEBIAN/
│   ├── control
│   ├── postinst
│   ├── prerm
│   └── conffiles
├── usr/
│   ├── bin/
│   │   └── lyra-cli
│   ├── lib/
│   │   └── lyra-ia/
│   │       ├── blockchain_core.py
│   │       ├── did_identity.py
│   │       ├── reputacion.py
│   │       ├── oraculo.py
│   │       ├── gobernanza.py
│   │       ├── contrato_mutual.py
│   │       ├── sistema_contradron.py
│   │       ├── motor_lyra.py
│   │       ├── lyra_domotica.py
│   │       ├── lyra_vpn_core.py
│   │       ├── lyra_core.py
│   │       └── lyra_cli.py
│   └── share/
│       ├── doc/lyra-ia-suite/
│       │   ├── README.md
│       │   ├── LICENSE
│       │   └── CHANGELOG.md
│       └── lyra-ia/
│           └── config.yaml
├── etc/
│   ├── lyra-ia/
│   │   └── lyra.conf
│   └── systemd/system/
│       ├── lyra-suite.service
│       └── lyra-vpn.service
└── var/
    └── log/lyra/
        └── .gitkeep
```

**Nombre del paquete:** `lyra-ia-suite`
**Versión:** `2.0.0-1`
**Arquitectura:** `all` (Python puro) o `arm64` si se compila algo
**Dependencias:** `python3 (>=3.9)`, `python3-venv`, `systemd`

---

## 📄 Parte 2 — Ficheros del paquete

### 2.1. `DEBIAN/control`

```
Package: lyra-ia-suite
Version: 2.0.0-1
Section: education
Priority: optional
Architecture: all
Depends: python3 (>= 3.9), python3-venv, systemd, curl
Maintainer: José Agustín Fontán Varela <jafv@pasaialab.example>
Homepage: https://pasaialab.example/lyra-ia
Description: LYRA IA Suite Educativa
 Conjunto de módulos educativos de simulación para el estudio de
 blockchain, identidad descentralizada, reputación on-chain,
 gobernanza DAO, domótica, VPN con enrutamiento IA y análisis OSINT.
 .
 Este paquete instala los módulos Python, la CLI, los servicios
 systemd y la documentación. El código es material didáctico y de
 arquitectura de referencia; no es software de producción ni ha
 sido auditado para uso en entornos críticos.
 .
 Incluye: LYRA-CHAIN, LYRA-ID, LYRA-REP, LYRA-ORACLE, LYRA-GOV,
 LYRA-MUTUAL, LYRA-CONTRADRON, LYRA-OSINT, LYRA-DOMO, LYRA-VPN,
 LYRA-CORE y LYRA-CLI.
```

### 2.2. `DEBIAN/postinst`

```bash
#!/bin/bash
set -e

# Crear usuario de sistema si no existe
if ! id -u lyra >/dev/null 2>&1; then
    useradd --system --home /var/lib/lyra --shell /usr/sbin/nologin lyra
fi

# Crear directorios de datos y logs
mkdir -p /var/lib/lyra /var/log/lyra
chown -R lyra:lyra /var/lib/lyra /var/log/lyra

# Crear entorno virtual e instalar dependencias (solo stdlib, pero por si acaso)
if [ ! -d /usr/lib/lyra-ia/venv ]; then
    python3 -m venv /usr/lib/lyra-ia/venv || true
fi

# Recargar systemd
systemctl daemon-reload

# Habilitar servicios (no arrancar automáticamente en modo educativo)
systemctl enable lyra-suite.service || true
systemctl enable lyra-vpn.service || true

echo "LYRA IA Suite instalada. Ejecuta 'lyra-cli estado' para empezar."
echo "Documentación: /usr/share/doc/lyra-ia-suite/README.md"

exit 0
```

### 2.3. `DEBIAN/prerm`

```bash
#!/bin/bash
set -e

systemctl stop lyra-suite.service || true
systemctl stop lyra-vpn.service || true
systemctl disable lyra-suite.service || true
systemctl disable lyra-vpn.service || true

exit 0
```

### 2.4. `usr/bin/lyra-cli`

```bash
#!/bin/bash
# Wrapper de la CLI de LYRA IA Suite
exec python3 /usr/lib/lyra-ia/lyra_cli.py "$@"
```

### 2.5. `etc/lyra-ia/lyra.conf`

```yaml
# Configuración de LYRA IA Suite (modo educativo)
modo: educativo
nivel_log: INFO
directorio_datos: /var/lib/lyra
directorio_logs: /var/log/lyra

blockchain:
  nombre: LYRA-MAIN-CHAIN
  validadores_iniciales: 3

vpn:
  puerto: 51820
  saltos_minimos: 3
  saltos_maximos: 7

domotica:
  entornos: [HOGAR, COCHE, CARAVANA, BARCO, REFUGIO]

osint:
  fuentes_rss: 8
  umbral_alerta: 0.55
```

### 2.6. `etc/systemd/system/lyra-suite.service`

```ini
[Unit]
Description=LYRA IA Suite - Orquestador Educativo
Documentation=file:/usr/share/doc/lyra-ia-suite/README.md
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=lyra
Group=lyra
WorkingDirectory=/usr/lib/lyra-ia
Environment="PYTHONUNBUFFERED=1"
Environment="LYRA_MODE=educativo"
ExecStart=/usr/bin/python3 /usr/lib/lyra-ia/lyra_core.py
Restart=on-failure
RestartSec=15
StandardOutput=append:/var/log/lyra/suite.log
StandardError=append:/var/log/lyra/suite.err

NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=read-only
ReadWritePaths=/var/log/lyra /var/lib/lyra
PrivateTmp=true

[Install]
WantedBy=multi-user.target
```

### 2.7. `etc/systemd/system/lyra-vpn.service`

```ini
[Unit]
Description=LYRA VPN - Red Privada Virtual Educativa
Documentation=file:/usr/share/doc/lyra-ia-suite/README.md
After=network-online.target

[Service]
Type=simple
User=lyra
Group=lyra
WorkingDirectory=/usr/lib/lyra-ia
Environment="PYTHONUNBUFFERED=1"
Environment="LYRA_VPN_MODE=educativo"
ExecStart=/usr/bin/python3 /usr/lib/lyra-ia/lyra_vpn_core.py
Restart=on-failure
RestartSec=10
StandardOutput=append:/var/log/lyra/vpn.log
StandardError=append:/var/log/lyra/vpn.err

NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=read-only
ReadWritePaths=/var/log/lyra /var/lib/lyra
PrivateTmp=true
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_BIND_SERVICE
CapabilityBoundingSet=CAP_NET_ADMIN CAP_NET_BIND_SERVICE

[Install]
WantedBy=multi-user.target
```

---

## 🔨 Parte 3 — Script de construcción del `.deb`

### 3.1. `build_deb.sh`

```bash
#!/bin/bash
# build_deb.sh — Construye el paquete lyra-ia-suite_2.0.0-1_all.deb
set -e

VERSION="2.0.0-1"
PKG="lyra-ia-suite_${VERSION}"
SRC_DIR="$(pwd)/src"
BUILD_DIR="$(pwd)/build/${PKG}"

echo "== Limpiando =="
rm -rf build
mkdir -p "${BUILD_DIR}"

echo "== Creando estructura =="
mkdir -p "${BUILD_DIR}/DEBIAN"
mkdir -p "${BUILD_DIR}/usr/bin"
mkdir -p "${BUILD_DIR}/usr/lib/lyra-ia"
mkdir -p "${BUILD_DIR}/usr/share/doc/lyra-ia-suite"
mkdir -p "${BUILD_DIR}/usr/share/lyra-ia"
mkdir -p "${BUILD_DIR}/etc/lyra-ia"
mkdir -p "${BUILD_DIR}/etc/systemd/system"
mkdir -p "${BUILD_DIR}/var/log/lyra"

echo "== Copiando módulos Python =="
cp "${SRC_DIR}"/*.py "${BUILD_DIR}/usr/lib/lyra-ia/"

echo "== Copiando CLI =="
cp scripts/lyra-cli "${BUILD_DIR}/usr/bin/"
chmod 755 "${BUILD_DIR}/usr/bin/lyra-cli"

echo "== Copiando configuración =="
cp config/lyra.conf "${BUILD_DIR}/etc/lyra-ia/lyra.conf"

echo "== Copiando servicios systemd =="
cp systemd/lyra-suite.service "${BUILD_DIR}/etc/systemd/system/"
cp systemd/lyra-vpn.service "${BUILD_DIR}/etc/systemd/system/"

echo "== Copiando documentación =="
cp docs/README.md "${BUILD_DIR}/usr/share/doc/lyra-ia-suite/"
cp docs/LICENSE "${BUILD_DIR}/usr/share/doc/lyra-ia-suite/"
cp docs/CHANGELOG.md "${BUILD_DIR}/usr/share/doc/lyra-ia-suite/"

echo "== Copiando metadatos DEBIAN =="
cp debian/control "${BUILD_DIR}/DEBIAN/control"
cp debian/postinst "${BUILD_DIR}/DEBIAN/postinst"
cp debian/prerm "${BUILD_DIR}/DEBIAN/prerm"
chmod 755 "${BUILD_DIR}/DEBIAN/postinst" "${BUILD_DIR}/DEBIAN/prerm"

echo "== Ajustando permisos =="
find "${BUILD_DIR}" -type d -exec chmod 755 {} \;
find "${BUILD_DIR}" -type f -exec chmod 644 {} \;
chmod 755 "${BUILD_DIR}/usr/bin/lyra-cli"
chmod 755 "${BUILD_DIR}/DEBIAN/postinst" "${BUILD_DIR}/DEBIAN/prerm"

echo "== Calculando md5sums =="
cd "${BUILD_DIR}"
find . -type f ! -path "./DEBIAN/*" -exec md5sum {} \; > DEBIAN/md5sums
cd - >/dev/null

echo "== Construyendo .deb =="
dpkg-deb --build --root-owner-group "${BUILD_DIR}" "build/${PKG}.deb"

echo "== Verificando =="
dpkg-deb --info "build/${PKG}.deb"
dpkg-deb --contents "build/${PKG}.deb" | head -20

echo "== Listo: build/${PKG}.deb =="
```

### 3.2. Instalación en Raspberry Pi OS

```bash
# En la Raspberry Pi
sudo apt update
sudo apt install -y python3 python3-venv systemd curl

# Instalar el paquete
sudo dpkg -i lyra-ia-suite_2.0.0-1_all.deb

# Si hay dependencias sin resolver
sudo apt install -f

# Comprobar
lyra-cli estado
systemctl status lyra-suite.service
```

### 3.3. Desinstalación limpia

```bash
sudo apt remove lyra-ia-suite
sudo apt purge lyra-ia-suite    # elimina también configuración
sudo rm -rf /var/lib/lyra /var/log/lyra
```

---

## 📣 Parte 4 — Campaña publicitaria

### 4.1. Posicionamiento honesto

**No vendemos un producto de seguridad.** Vendemos **material educativo libre** para aprender arquitecturas de IA, blockchain e identidad descentralizada sobre Raspberry Pi.

**Lema:** *"LYRA IA Suite Educativa — Aprende construyendo la capa cívica de la IA."*

### 4.2. Público objetivo

| Segmento | Mensaje | Canal |
| :--- | :--- | :--- |
| **Ikastolas y centros de FP** | "Un currículo completo de IA, blockchain y domótica para tu aula" | Email a centros, ferias educativas |
| **Universidades** | "Arquitectura de referencia para investigación en identidad y gobernanza" | ResearchGate, congresos |
| **Maker community** | "Instala en tu Raspberry Pi en 3 comandos" | Reddit r/raspberry_pi, Hackster.io, Mastodon |
| **Soberanía digital** | "Alternativa libre a las cajas negras de la IA" | Mastodon, Bluesky, foros de software libre |
| **Cooperativas y ayuntamientos** | "Infraestructura digital comunitaria" | Contacto directo, jornadas |

### 4.3. Materiales de campaña

| Pieza | Formato | Contenido |
| :--- | :--- | :--- |
| **Landing page** | Web | Qué es, qué no es, instalación en 3 pasos, enlace al `.deb`, licencia, disclaimer |
| **README destacado** | Markdown | Requisitos, instalación, primeros pasos, módulos, limitaciones |
| **Vídeo de 90 s** | MP4 | Pantalla de Raspberry Pi, `dpkg -i`, `lyra-cli estado`, primeros módulos |
| **Hilo de Mastodon** | 8 posts | Qué es, qué no es, cómo instalar, qué aprenderás, licencia |
| **Cartel A3** | PDF | Código QR al `.deb` y a la landing |
| **Ficha para ikastolas** | PDF | Alineación curricular, talleres, materiales |

### 4.4. Calendario de lanzamiento (4 semanas)

| Semana | Acción |
| :--- | :--- |
| **1** | Publicar landing + README + `.deb` en GitHub Releases |
| **2** | Hilo de Mastodon + vídeo + contacto a 20 ikastolas |
| **3** | Publicación en Hackster.io + Reddit + foro Raspberry Pi |
| **4** | Webinar de 1 h "Instala LYRA en tu Raspberry Pi" + recogida de feedback |

### 4.5. Mensajes clave (y lo que NO decir)

| ✅ Decir | ❌ No decir |
| :--- | :--- |
| "Material educativo libre" | "Producto de seguridad" |
| "Arquitectura de referencia" | "Listo para producción" |
| "Aprende construyendo" | "Protege tu empresa" |
| "Código auditable" | "Cifrado de grado militar" |
| "Compatible con Raspberry Pi OS" | "Sustituye a tu VPN actual" |

---

## 🏛️ Parte 5 — CERTIFICACIÓN

**Nº de Registro:** PL-DIST-LYRA-2026-10-20
**Fecha:** 20 de octubre de 2026 · **Lugar:** Pasaia (Gipuzkoa), Euskadi

Se certifica que el **paquete de distribución `lyra-ia-suite_2.0.0-1_all.deb`** y su **campaña de comunicación** han sido diseñados por **José Agustín Fontán Varela**, CEO de **PASAIA LAB**, con la colaboración de **INTELIGENCIA LIBRE**, **SISTEMA LYRA IA**, **FORJA**, **ACCIÓN CIVIL DIGITAL** y **DeepSeek IA – Asesor Inteligente**, bajo la clasificación **DISTRIBUCIÓN CONTROLADA**.

**Componentes certificados:**
1. Estructura `deb` estándar con `control`, `postinst`, `prerm`, `md5sums`.
2. Instalación en `/usr/lib/lyra-ia/`, CLI en `/usr/bin/lyra-cli`, configuración en `/etc/lyra-ia/`.
3. Servicios systemd `lyra-suite.service` y `lyra-vpn.service` con hardening (`NoNewPrivileges`, `ProtectSystem`, `PrivateTmp`).
4. Script `build_deb.sh` reproducible.
5. Documentación en `/usr/share/doc/lyra-ia-suite/`.
6. Campaña de comunicación con posicionamiento honesto (material educativo, no producto de seguridad).

**Advertencias certificadas:**
- El código es **material educativo de simulación**, no software de producción.
- No ha sido auditado para uso en entornos críticos.
- El cifrado de los módulos es **simulado** (XOR + HMAC), no AES-GCM real.
- La campaña **no debe presentar el paquete como producto de seguridad**.

**Firmado:**
- **José Agustín Fontán Varela** — CEO de PASAIA LAB
- **INTELIGENCIA LIBRE** — Validación Metodológica
- **SISTEMA LYRA IA** — Innovación en IA
- **FORJA** — Solidez Técnica
- **ACCIÓN CIVIL DIGITAL** — Relevancia Social
- **DeepSeek IA** — Asistencia Técnica y Validación

---

 

## 🎨 Prompt para la imagen de certificación

> *"Certificado oficial de estilo **documento de distribución controlada**, formato vertical (9:16), resolución 8K. Fondo beige pergamino con cuadrícula de datos y marca de agua 'CONFIDENCIAL · LYRA NEXUS'. Cabecera roja con 'DISTRIBUCIÓN CONTROLADA // PASAIA LAB'. Título 'CERTIFICADO DE PAQUETE DE DISTRIBUCIÓN', subtítulo 'LYRA IA Suite Educativa · Paquete .deb para Debian y Raspberry Pi OS'. Bloque de autoría: 'JOSÉ AGUSTÍN FONTÁN VARELA · CEO DE PASAIA LAB'. Dos columnas: izquierda 'COMPONENTES DEL PAQUETE' con seis viñetas (estructura deb, instalación, servicios systemd, script de build, documentación, campaña); derecha 'ADVERTENCIAS CERTIFICADAS' con cuatro viñetas (material educativo, no auditado, cifrado simulado, no presentar como producto de seguridad). Recuadro central con la estructura de directorios del paquete en tipografía monoespaciada. Franja inferior con logos de PASAIA LAB, INTELIGENCIA LIBRE, SISTEMA LYRA IA, FORJA, ACCIÓN CIVIL DIGITAL y DEEPSEEK IA. Sello de cera rojo, QR 'VERIFICAR AUTENTICIDAD' y referencia 'PL-DIST-LYRA-2026-10-20'. Paleta: beige, azul noche, dorado, rojo carmesí, cian, verde esmeralda, blanco perla. Estilo documento oficial escaneado."*

---

## 🎨 Prompt para la campaña: "Instala LYRA en tu Raspberry Pi"

> *"Póster promocional de estilo **editorial y didáctico**, formato horizontal (16:9), resolución 8K. Fondo azul noche con una Raspberry Pi 5 estilizada en el centro, sobre la que flota un cubo de luz cian con el ojo de LYRA. Alrededor, seis iconos de los módulos (blockchain, identidad, reputación, gobernanza, domótica, VPN) conectados por líneas doradas. En la parte inferior, tres comandos en tipografía monoespaciada blanca sobre fondo negro: 'sudo apt install -y python3 python3-venv', 'sudo dpkg -i lyra-ia-suite_2.0.0-1_all.deb', 'lyra-cli estado'. A la derecha, un recuadro con la etiqueta 'MATERIAL EDUCATIVO LIBRE · NO ES UN PRODUCTO DE SEGURIDAD' en rojo carmesí. Título superior: 'INSTALA LYRA EN TU RASPBERRY PI' en serif 3D dorada. Subtítulo: 'Aprende construyendo la capa cívica de la IA · Debian · Raspberry Pi OS'. Franja inferior con logos de PASAIA LAB, INTELIGENCIA LIBRE, SISTEMA LYRA IA, FORJA, ACCIÓN CIVIL DIGITAL y DEEPSEEK IA. Paleta: azul noche, cian, dorado, verde esmeralda, rojo carmesí, blanco perla. Estilo The Economist + Hackster.io + póster didáctico."*

---

## 🎨 Prompt para la imagen: "El paquete .deb abierto"

> *"Infografía técnica de estilo **manual de instrucciones moderno**, formato horizontal (16:9), resolución 8K. Centro: un **paquete .deb estilizado** abierto como una caja, del que salen flotando los módulos Python (blockchain_core.py, did_identity.py, reputacion.py, oraculo.py, gobernanza.py, contrato_mutual.py, sistema_contradron.py, motor_lyra.py, lyra_domotica.py, lyra_vpn_core.py, lyra_core.py, lyra_cli.py) como tarjetas luminosas. A la izquierda, la **estructura de directorios** en tipografía monoespaciada (DEBIAN/, usr/bin/, usr/lib/lyra-ia/, etc/systemd/system/, var/log/lyra/). A la derecha, los **servicios systemd** con sus nombres y la etiqueta 'HARDENING: NoNewPrivileges · ProtectSystem · PrivateTmp'. En la parte inferior, una **terminal** con los comandos de instalación y la salida de `lyra-cli estado`. Título superior: 'EL PAQUETE .DEB ABIERTO' en serif 3D dorada, subtítulo 'LYRA IA Suite Educativa · Debian · Raspberry Pi OS'. Franja institucional con logos de PASAIA LAB, INTELIGENCIA LIBRE, SISTEMA LYRA IA, FORJA, ACCIÓN CIVIL DIGITAL y DEEPSEEK IA, sello 'PL-DIST-LYRA-2026-10-20'. Paleta: azul noche, cian, dorado, verde esmeralda, blanco perla, gris piedra. Estilo manual técnico + Hackster.io."*

---

## 📌 Resumen ejecutivo

| Entregable | Estado |
| :--- | :--- |
| Estructura del paquete `deb` | ✅ Diseñada |
| `control`, `postinst`, `prerm` | ✅ Escritos |
| Servicios systemd con hardening | ✅ Escritos |
| `build_deb.sh` reproducible | ✅ Escrito |
| Configuración `/etc/lyra-ia/lyra.conf` | ✅ Escrita |
| Campaña de comunicación (público, mensajes, calendario) | ✅ Diseñada |
| Certificación | ✅ Emitida |
| Prompts visuales | ✅ Tres prompts |

 

 

 

 

 

 

 

 

**Firmado:**
- **José Agustín Fontán Varela** — CEO de PASAIA LAB
- **INTELIGENCIA LIBRE** — Validación Metodológica
- **SISTEMA LYRA IA** — Innovación en IA
- **FORJA** — Solidez Técnica
- **ACCIÓN CIVIL DIGITAL** — Relevancia Social
- **DeepSeek IA** — Asistencia Técnica y Validación

 

TODO LO QUE NECESITAS ESTÁ EN LAS VARIADAS Y DIFERENTES ENTRADAS DE ESTE BLOG - SISTEMA LYRA IA - IA LYRA NEXUS - IA LYRA ;)