Skip to content

02 Instalacion

Jump to bottom
glitchboi edited this page Oct 30, 2026 · 4 revisions

Instalación

Requisitos Previos

Sistema Operativo

  • Linux (cualquier distribución moderna)
  • Python 3.9 o superior
  • PySide6/Qt para la app de escritorio (se instala vía requirements.txt con pip)

Dependencias del Sistema

Ubuntu/Debian:

sudo apt update
sudo apt install python3 python3-pip python3-venv make

Fedora/RHEL/CentOS:

sudo dnf install python3 python3-pip make

Arch Linux:

sudo pacman -S python python-pip make

Método 1: Instalación con make (Recomendado)

Este es el método más rápido y confiable. Todos los comandos de desarrollo viven en el Makefile (ejecuta make help para ver la lista completa).

# 1. Clonar el repositorio
git clone https://github.com/Glitchboi-sudo/Blackwire.git
cd Blackwire

# 2. Instalar (crea el venv, instala deps y genera el certificado mitmproxy)
make install

# 3. Arrancar el backend en segundo plano
make start

# 4. Lanzar la app de escritorio nativa
python desktop/run.py

Como atajo, make run hace todo en un solo paso: instala, arranca el backend y lanza la app de escritorio.

El backend queda escuchando en http://localhost:5000 (API REST), pero la interfaz es la ventana de escritorio nativa, no un navegador apuntando a localhost:5000.

Qué hace make install

El objetivo install ejecuta venv, deps y cert:

  1. Crea el entorno virtual en venv/
  2. Actualiza pip e instala dependencias desde requirements.txt
  3. Genera el certificado CA de mitmproxy en ~/.mitmproxy/ (solo si no existe)

Comandos disponibles

Comando Descripción
make install Crea el venv, instala dependencias y genera el certificado mitmproxy
make run Instala, arranca el backend y lanza la app de escritorio
make serve Backend en primer plano (Ctrl-C para detener)
make start Backend en segundo plano
make stop Detiene el backend
make restart Reinicia el backend (necesario tras cambios en backend o extensiones)
make cert Genera el certificado CA de mitmproxy si no existe
make verify Verifica dependencias
make clean Elimina venv, cachés y artefactos de runtime
make help Lista todos los objetivos
python desktop/run.py Lanza la app de escritorio nativa (GUI)
python desktop/run.py --selftest Prueba de humo sin interfaz (headless)

Método 2: Instalación Manual

Si prefieres control total sobre cada paso:

# 1. Crear y activar el entorno virtual
python3 -m venv venv
source venv/bin/activate

# 2. Actualizar pip e instalar dependencias Python
pip install --upgrade pip
pip install -r requirements.txt

# 3. Generar el certificado CA de mitmproxy (o usa `make cert`)
python3 -c "from mitmproxy import certs; certs.CertStore.from_store('$HOME/.mitmproxy', 'mitmproxy', 2048)"

# 4. Arrancar el backend
make serve     # primer plano (Ctrl-C para parar)
# o
make start     # segundo plano

# 5. Lanzar la app de escritorio nativa
python desktop/run.py

Versión Desktop (PyInstaller + Docker)

La versión Desktop empaqueta BlackWire como aplicación standalone con bundles nativos y aislamiento Docker completo.

Cómo se construye

Los bundles se generan con GitHub Actions mediante el workflow .github/workflows/desktop.yml, que se dispara al publicar un tag v* (por ejemplo v2.0.0).

El workflow produce un GitHub Release con bundles para:

  • Linux
  • macOS
  • Windows

Descárgalos desde la sección Releases.

Características

  • Aplicación nativa PySide6/Qt empaquetada con PyInstaller
  • Backend aislado en un contenedor Docker, gestionado por la propia GUI
  • Servidor MCP integrado (blackwire-desktop --mcp)

Clone this wiki locally