Instalar

Dos canales, excluyentes entre sí en una misma máquina: el paquete para su sistema, o un clon de Git si piensa modificar el propio Diwall.

Qué se instala dónde

/opt/diwall/               programas, entorno de Python, Chromium (ambos canales)
├── shot.py rpa.py watch.py
├── lib/ scenarios/ docs/
├── venv/                  entorno de Python aislado, creado durante la instalación
└── .cache/ms-playwright/  Chromium, descargado por Playwright durante la instalación
/usr/bin/diwall-*          los seis comandos (canal del paquete)
/etc/diwall/diwall.conf    configuración (canal del paquete)
/opt/diwall/diwall.conf    configuración (canal del clon de Git)
/var/log/diwall/           registro (operations.jsonl) y archivos de evidencias
/tmp/diwall/               las capturas de cada ejecución, eliminadas al reiniciar
~/Vaults/Diwall/           credenciales cifradas (gocryptfs), montadas por usted

Cada comando diwall-* ejecuta el programa correspondiente con /opt/diwall/venv/bin/python3; lo único que añade es dónde encontrar la configuración. diwall.conf nunca se crea automáticamente, y permite trasladar el registro de operaciones (journal.chemin) y el directorio de credenciales (secrets_dir) a otro lugar.

Dos canales, uno por máquina

Tome el paquete a menos que tenga la intención de modificar el propio código de Diwall. Los dos canales son excluyentes entre sí en una misma máquina, por dos motivos:

ambos instalan en el mismo /opt/diwall/, y el gestor de paquetes no conoce los archivos que install.sh coloca allí — ni una actualización ni una eliminación los tiene en cuenta;
leen su configuración de dos lugares distintos, por lo que en una máquina con ambos, la configuración aplicada depende de si usted escribió diwall-shot o ejecutó shot.py.

install.sh, deploy.sh y uninstall.sh se niegan a ejecutarse en una máquina donde hay un paquete instalado, y muestran el comando que lo elimina. El paquete, en cambio, no detecta una instalación por clon de Git: en ese sentido, atenerse a uno solo depende de usted.

Qué necesita

Medido el 25 de septiembre de 2026, en Debian 13.7 con Diwall 1.24.0 — estas cifras cambiarán, y la fecha es lo que las mantiene honestas.

Requisito	Valor
Sistema	Debian 13, Ubuntu 24.04 y 26.04, Fedora 44, openSUSE Leap 16.0 y Arch Linux; cada uno validado en un contenedor limpio de su sistema, sin pantalla ni montaje FUSE. El `.deb` depende de bibliotecas llamadas `t64` (`libasound2t64`, `libatk1.0-0t64`…), que Debian 12 y Ubuntu 22.04 no proporcionan. Los demás sistemas no están soportados — no por principio, sino porque no son los que se han probado.
Red	Necesaria durante la instalación: `pip` obtiene las dependencias de Python y Playwright descarga Chromium.
Python	El propio de Debian (3.13.5 en Debian 13.7), a partir del cual se crea un entorno aislado.
Navegador	Chromium descargado por Playwright 1.62.0 (build 1234) en `/opt/diwall/.cache/ms-playwright/` — nunca el navegador del sistema.
Disco	909 MB para `/opt/diwall/` una vez instalado; el propio `.deb` ocupa 488 kB.
Visión local, opcional	Ollama con `qwen3-vl:2b` (1,9 GB), el modelo predeterminado de `cliquer_visuel` y de la comparación semántica de `diwall-watch`. Ningún canal lo instala.

Paquete — la vía sencilla

Descargue el archivo de su sistema de la última versión publicada o de la página Descargas, y luego:

sudo apt install ./diwall_1.24.4-1_all.deb   # Debian 13, Ubuntu 24.04, Ubuntu 26.04
sudo dnf install ./diwall-1.24.4-1.fc44.noarch.rpm   # Fedora 44
sudo zypper install --allow-unsigned-rpm ./diwall-1.24.4-1.leap160.noarch.rpm   # openSUSE Leap 16.0
sudo pacman -U ./diwall-1.24.4-1-any.pkg.tar.zst   # Arch Linux

Eso es todo. Crea el usuario de sistema diwall, el entorno virtual y /opt/diwall/, instala los seis comandos diwall-* en su PATH e incluye la página de manual:

man diwall
diwall-shot --version

La configuración se encuentra en /etc/diwall/diwall.conf, con un ejemplo comentado instalado al lado.

La actualización es el mismo comando con un archivo más reciente; su configuración se conserva.

La desinstalación depende de la familia. En Debian y Ubuntu, sudo apt remove diwall conserva la configuración, el registro y las capturas de referencia con la cuenta diwall que los protege; sudo apt purge diwall lo elimina todo. En Fedora, openSUSE y Arch hay un solo comando (sudo dnf remove diwall, sudo zypper remove diwall, sudo pacman -R diwall): borra lo que se puede reconstruir —entorno virtual, Chromium—, conserva lo que usted ha producido con la cuenta diwall y muestra el comando que lo borra. Si no ha producido nada, no queda nada.

Desde las fuentes — para modificar el propio Diwall

git clone https://github.com/RonanDavalan/diwall.git
cd diwall
bash scripts/install.sh

Este canal existe para que todo el entorno pueda reconstruirse a partir del repositorio Git únicamente. Si faltara un solo paso en la documentación, la reconstrucción fallaría — por eso se prueba en lugar de suponerse.

Después, antes que nada

Diwall se niega a ejecutarse mientras quien lo pilota no haya leído la guía y no sea capaz de citar su número de versión. No es una formalidad: un agente que no la ha leído improvisa, e improvisar con credenciales y con un navegador es exactamente lo que el cerrojo existe para impedir.

grep notice-version /opt/diwall/docs/GUIDE_LLM.md

El número que muestra es el que usted pasa a --guide-version.

Su primera ejecución →