refugiOS

refugiOS - Tu Refugio Digital y Biblioteca de Supervivencia

🇬🇧🇺🇸 Read this in English

¿Qué es refugiOS?

refugiOS es un sistema operativo portátil pensado para funcionar sin conexión a Internet en situaciones de emergencia o de resiliencia personal. Se instala en un USB y arranca en cualquier PC de 64 bits (con soporte dual tanto para UEFI moderno como para BIOS tradicional) o Raspberry Pi, llevando contigo Wikipedia completa, mapas offline de todo el mundo, una IA privada local, cifrado de archivos personales y guías de supervivencia, todo funcionando sin depender de ningún servidor ni nube.

La idea es sencilla: prepáralo hoy en casa, úsalo cuando no haya Internet.

→ Consulta la Visión y Experiencia del Usuario para una descripción completa del proyecto y qué esperar al usarlo.

Inicio Rápido: Descarga la Imagen Pregenerada

La forma más fácil de tener refugiOS es descargar la imagen ya preparada, grabarla en un USB y arrancar:

1. Descarga la imagen

Última actualización de las imágenes: 25 de octubre de 2026 (versión 0.27). Si descargaste una imagen anterior a esta fecha, sustitúyela para contar con todas las correcciones, el actualizador, el traductor y la nueva biblioteca.

Descomprime el .zip antes de grabarlo: en Windows, clic derecho → Extraer todo; en Linux o macOS, unzip refugios-base-16G-es.img.zip. Obtendrás el fichero .img que se graba en el USB.

sha256sum --ignore-missing -c SHA256SUMS.txt   # Linux
shasum -a 256 --ignore-missing -c SHA256SUMS.txt   # macOS

Necesitas un USB de al menos 16 GB. La partición del sistema se expandirá automáticamente al tamaño completo del USB en el primer arranque.

[!NOTE] ¿Por qué no se ofrece una imagen completamente configurada de antemano? Ofrecer una imagen lista con todos los contenidos posibles (Wikipedia completa con imágenes, múltiples modelos de IA local, cartografía de todo el mundo, etc.) exigiría un archivo de descarga descomunal de más de 150 GB. Por eso se distribuye una imagen base ligera que el usuario debe configurar en un entorno controlado (no de emergencia) con una buena conexión a Internet. De este modo, en el momento de una emergencia real, el dispositivo tendrá exactamente la información y recursos específicos que necesites.

2. Graba la imagen en tu USB

Desde Windows — Usa Rufus o balenaEtcher:

1. Abre Rufus, selecciona tu USB y el archivo .img descargado.
2. Asegúrate de que el esquema de partición es GPT y el sistema destino es UEFI.
3. Pulsa Empezar y espera.

Desde Linux — Con el comando dd:

# ¡Verifica con lsblk que /dev/sdX es tu USB!
sudo dd if=refugios-base-16G-es.img of=/dev/sdX bs=4M status=progress conv=fsync

Desde macOS — Usa balenaEtcher o el comando dd:

sudo dd if=refugios-base-16G-es.img of=/dev/diskN bs=4M

3. Arranca desde el USB

1. Conecta el USB a cualquier PC y enciéndelo.
2. Pulsa F12, F8 o Esc durante el arranque para seleccionar el USB como dispositivo de inicio.
3. El sistema arrancará automáticamente en el escritorio XFCE con el usuario refugios (sin contraseña).

4. Completa la instalación

En el escritorio encontrarás el icono “Completar instalación de refugiOS”. Haz doble clic sobre él, conéctate a Internet cuando te lo pida, y el asistente se encargará de descargar e instalar todo el contenido según la capacidad de tu USB.

También puedes ejecutarlo desde la terminal:

curl -fsSL https://raw.githubusercontent.com/Ganso/refugiOS/main/install.sh | bash

Métodos Alternativos

La imagen pregenerada es la forma más rápida y sencilla, pero si lo necesitas, también puedes montar refugiOS de otras maneras:

sudo bash scripts/build_refugios.sh 16G

Probar en una Máquina Virtual

Si quieres probar refugiOS antes de grabarlo en un USB, puedes arrancar cualquiera de las imágenes (pregenerada o construida por ti) en una máquina virtual con QEMU o VirtualBox. Esto funciona para x86 (PC y Xubuntu); la Raspberry Pi requiere hardware real.

# Con QEMU y aceleración KVM (Linux)
sudo qemu-system-x86_64 -enable-kvm -m 4G \
  -bios /usr/share/ovmf/OVMF.fd \
  -drive file=refugios-base-16G-es.img,format=raw

Consulta la Guía de Virtualización para instrucciones completas con QEMU, VirtualBox y métodos para probar imágenes de Xubuntu.

Características Principales

• ⚡ Arranca en cualquier PC: Conectas el USB, enciendes y tu refugio digital funciona. No installs nada en el ordenador anfitrión.
• 🍓 Soporte nativo para Raspberry Pi: Instalación certificada en Raspberry Pi 3B+.
• 📚 Conocimiento Universal Offline: Wikipedia, enciclopedia médica, guías de emergencia y supervivencia, reparaciones, energía, diccionario y libros, organizados por categorías.
• 🤖 Inteligencia Artificial Privada: Asistente que funciona 100% en local, sin Internet.
• 🗺️ Mapas y Navegación GPS: Mapas offline de todo el mundo con Organic Maps, con los países más habituales listos desde el instalador.
• Traductor sin conexión: Más de 40 idiomas con los modelos neuronales de Firefox.
• Actualizable sin riesgo: Un icono pone al día libros, mapas, IA y aplicaciones, y no borra nada antiguo hasta verificar lo nuevo.
• Comprobación sin conexión: Un icono revisa que libros, IA, mapas y bóvedas están completos e intactos antes de necesitarlos.
• 🔒 Bóveda de Archivos Segura: Cifrado profesional LUKS para proteger documentos sensibles.
• 🌐 Adaptado a tu Idioma: El sistema se configura automáticamente en español o inglés.

Consulta el Roadmap y Aplicaciones para ver el estado actual del proyecto.

Vídeo de Demostración

refugiOS corriendo en un Ryzen 5500, arrancado desde un pendrive USB 3.2 de gama de consumo

Documentación Detallada

Fundamentos

• Visión y Experiencia del Usuario: Qué es refugiOS y qué esperar al usarlo.
• Comparativa de Soluciones: Por qué refugiOS es diferente a otras alternativas.
• Arquitectura del Sistema: Detalles técnicos sobre la base Linux y su rendimiento.

Instalación y Configuración

• Elección del Medio de Instalación: Qué USB o SSD comprar según tu presupuesto.
• Guía de Virtualización: Cómo probar refugiOS en una máquina virtual (QEMU, VirtualBox).
• Instalación en Xubuntu: Método alternativo sobre Live-USB de Xubuntu.
• Instalación en Raspberry Pi: Guía específica para Raspberry Pi.
• Construcción de Imagen de Sistema: Cómo generar tu propia imagen desde cero.
• Tabla de Compatibilidad: Distribuciones y hardware certificado.

Uso y Mantenimiento

• Bóvedas de Seguridad: Cómo funciona el cifrado de archivos personales.
• Clonado de Unidades: Cómo hacer copias exactas de tu USB.
• Aplicaciones y Roadmap: Módulos disponibles y planificados.

Historial de Versiones

[0.28] - 2026-11-01

Eliminado

• WikEM retirado del catálogo: El archivo ZIM de WikEM no está publicado en los servidores de Kiwix (receta en pausa por bloqueos de origen), evitando fallos en la instalación. Se conservan WikiMed y los manuales de medicina de campaña.

Corregido

• Mensaje de componente ZIM no encontrado: Mensaje en i18n.py clarificado (“No fue posible encontrar ninguna edición publicada de…”), eliminando el término erróneo “rastreador”.

[0.27] - 2026-10-25

Añadido

• Actualizador integrado (Actualizar refugiOS): Búsqueda y descarga atómica de nuevas ediciones de libros, motor llamafile, modelos de IA y regiones de mapa; la versión antigua solo se sustituye cuando la nueva está descargada y verificada.
• Traductor neuronal offline (LocalTranslate): Traducción entre más de 40 idiomas de forma 100% autónoma y privada gracias a modelos integrados.
• Biblioteca organizada por categorías: Nuevos catálogos de salud y medicina, supervivencia y emergencias, conocimiento práctico y reparaciones, y educación/libros, accesibles desde la carpeta Biblioteca refugiOS.
• Auditoría de integridad (Comprobar refugiOS): Script de autodiagnóstico sin red que verifica la integridad de libros, IA, mapas y bóvedas con opción de recálculo de sumas criptográficas.
• Descargas verificadas por defecto: Descarga mediante metalinks multimirror y BitTorrent con verificación SHA-256 de cada recurso.

Corregido

• Soporte de Flatpaks en Raspberry Pi: Permite instalar Organic Maps y LocalTranslate vía Flatpak en ARM64 si no hay paquete APT nativo disponible.
• Retirada de light-locker: Previene bloqueos accidentales de sesión por inactividad en usuarios con autologin sin contraseña.
• Estimaciones de espacio exactas: Ajustadas a mediciones reales de la imagen base y paquetes compartidos.

→ Consulta el CHANGELOG.md para el detalle completo de esta versión.

[0.26] - 2026-09-10

Corregido

• Arranque universal limpio: Retirada de módulos DKMS propietarios en la imagen base que provocaban bloqueos en Loading initial ramdisk en máquinas virtuales y equipos sin GPU NVIDIA reciente.
• Herramientas de instalación preinstaladas en la imagen: Se incluyen de serie dialog, aria2, jq, rsync, etc., evitando fallos si se ejecuta el instalador sin red.
• Presets de IA adaptados a la RAM: El instalador ya no recomienda modelos pesados a equipos con menos de 6 GB de RAM.

Añadido

• Instalación asistida de drivers NVIDIA: Detección interactiva para aceleración CUDA opcional.

→ Consulta el CHANGELOG.md para el detalle completo de esta versión.

→ Consulta el CHANGELOG.md para el historial completo de versiones.

Material Gráfico

La carpeta media/ reúne todo el material gráfico del proyecto:

• Logotipo en PNG, PDF vectorial y fuente de Illustrator, más el fondo de escritorio que aplica el instalador. Diseño de Felipe Monge “PlayOnRetro”; cítalo siempre que lo uses.
• Capturas de pantalla — cuarenta capturas de las aplicaciones principales funcionando, en español y en inglés, tomadas sobre el sistema real.

Star History

Agradecimientos y Fuentes

Gracias a Felipe Monge “PlayOnRetro” por el diseño del logo.

refugiOS es posible gracias al increíble trabajo de proyectos de código abierto como:

• Debian y Xubuntu por la base del sistema operativo.
• Raspberry Pi Foundation por el hardware y el ecosistema de software ARM.
• Kiwix y la Fundación Wikimedia por el acceso offline al conocimiento universal.
• Mozilla Ocho por el motor de inferencia Llamafile.
• HuggingFace y unsloth por las cuantizaciones optimizadas de los modelos de IA.
• Modelos de lenguaje Qwen3 (Alibaba-Qwen: 0.6B, 8B, 14B) y Gemma-4 (Google: E4B, 26B-A4B).
• Organic Maps y los colaboradores de OpenStreetMap por la cartografía offline.
• Aria2 para las descargas de alta eficiencia.
• Flatpak y Flathub por la distribución de aplicaciones modernas.
• Cryptsetup / LUKS para la seguridad y cifrado de datos personales.

(refugiOS es una iniciativa de código abierto para la resiliencia digital. Actualmente en fase Beta, buscamos colaboradores para internacionalizar la documentación y pulir la experiencia de usuario según nuestro Roadmap).