GUÍA DE INSTALACIÓN
Fararoni Suite — Instalación en macOS, Windows y Linux
Guía completa para instalar el ecosistema Fararoni en los tres sistemas operativos principales.
macOS (DMG)
Archivo: Fararoni-Installer.dmg
Al abrir el DMG se muestran 3 elementos:
| Elemento | Descripción |
|---|---|
| Fararoni Suite/ | Carpeta con el bundle completo (core + 4 sidecars + config) |
| Instalar Fararoni.command | Doble-clic para ejecutar el wizard de instalación |
| Applications | Symlink — arrastra "Fararoni Suite" aquí para instalar en /Applications |
Pasos
- Abrir
Fararoni-Installer.dmg - Opción A: Doble-clic en "Instalar Fararoni.command" (wizard interactivo)
- Opción B: Arrastrar "Fararoni Suite" a Applications (instalación manual)
- Configurar credenciales en
~/.fararoni/config/
Contenido de Fararoni Suite/
bin/
fararoni-core # Core Java (GraalVM native o JAR wrapper)
fararoni.sh # Script de arranque
sidecar-telegram # Sidecar Telegram (SEA binary)
sidecar-whatsapp # Sidecar WhatsApp (SEA binary)
sidecar-discord # Sidecar Discord (SEA binary)
sidecar-imessage # Sidecar iMessage (SEA binary)
lib/
fararoni-gateway-rest-1.0.0.jar
fararoni-enterprise-transport-1.0.0.jar
fararoni-launcher.sh # Orquestador: inicia core + sidecars
installer.sh # Wizard de instalación (macOS/Linux)
global.env # Variables de entorno globales
LICENSE # Apache 2.0Windows (ZIP)
Archivo: fararoni-v1.0.0.zip
Pasos
- Descomprimir
fararoni-v1.0.0.zip - Doble-clic en "Instalar Fararoni.bat" (wizard PowerShell)
- O ejecutar manualmente:
powershell -File installer.ps1 - Configurar credenciales en
%USERPROFILE%\.fararoni\config\
Linux (TAR.GZ)
Archivo: fararoni-v1.0.0.tar.gz
Pasos
tar xzf fararoni-v1.0.0.tar.gzcd fararoni-v1.0.0 && chmod +x installer.sh && ./installer.sh- Configurar credenciales en
~/.fararoni/config/ - Los sidecars se registran como servicios systemd
Generación Cross-Platform (CI/CD)
Para generar instaladores nativos en las 3 plataformas se utiliza un pipeline CI:
GitHub Actions Matrix:
- macos-latest (arm64) → DMG + ZIP
- ubuntu-latest (x64) → TAR.GZ + .deb (opcional)
- windows-latest (x64) → ZIP + MSI (opcional)Cada plataforma ejecuta:
./build-sidecars.sh→ genera binarios SEA nativos para ese OSmvn package→ empaqueta en ZIP/TAR.GZ- macOS:
./create-dmg.sh→ genera DMG - Linux:
dpkg-deborpmbuild(opcional) - Windows: WiX Toolset o Inno Setup (opcional)
Los sidecars SEA son platform-specific porque embeben el binario de Node.js del OS donde se compilan.
Código fuente
Guía completa disponible en el repositorio:
github.com/ebercruzf/fararoni-ecosystem — INSTALL-GUIDE.md