Instalación y primer inicio

Tres pasos para tener Spendif.ai funcionando en tu computadora: descargar, instalar, primer inicio. Todo offline, sin cuenta.

Qué obtienes

1Descarga para tu sistema

Los instaladores oficiales se publican como activos de cada GitHub Release. Elige el formato adecuado para tu SO.

🍎

macOS

SpendifAi-*.dmg
Descargar DMG
macOS 12 Monterey o superior. Apple Silicon + Intel.
🪟

Windows

SpendifAi-*.msix
Descargar MSIX
Windows 10 1809+ / Windows 11. Sideload + cert de confianza requeridos en la fase pre-alfa.
🐧

Debian / Ubuntu

spendifai_*_amd64.deb
Descargar .deb
Ubuntu 22.04+, Debian 12+, Mint 21+.
🎩

Fedora / RHEL

spendifai-*.rpm
Descargar .rpm
Fedora 40+, RHEL 9+, Rocky / Alma 9+.

¿Buscas una versión específica? Ver todas las releases · Código fuente: drake69/spendif-ai.

2Instalar

macOS — DMG

1. Doble clic en el archivo .dmg descargado.

2. Arrastra Spendif.ai.app a la carpeta Aplicaciones.

3. Expulsa el DMG (Cmd+E) y lanza la app desde el Launchpad.

Si ves "No se puede abrir Spendif.ai porque no se puede verificar al desarrollador" (build aún no firmada): clic derecho en la app → Abrir → confirmar.

📷 Captura
assets/screenshots/macos-dmg-dragdrop.png
(arrastrar & soltar del DMG a Aplicaciones)

Windows — MSIX

1. Doble clic en el archivo .msix descargado.

2. Se abre el Instalador de Apps integrado en Windows. Pulsa Instalar.

3. La app aparece en el Menú Inicio y se lanza desde allí.

Si ves "Editor desconocido": abre PowerShell como admin e importa el certificado una vez (consulta la guía).

📷 Captura
assets/screenshots/windows-msix-install.png
(diálogo Instalador de Apps de Windows)

Linux — .deb / .rpm

Desde la terminal:

sudo apt install ./spendifai_*.deb  (Debian/Ubuntu)

sudo dnf install ./spendifai-*.rpm  (Fedora/RHEL)

El postinst instala uv, crea el venv, descarga el modelo y configura .env. Guía completa: guía de instalación.

📷 Captura
assets/screenshots/linux-deb-install.png
(salida del terminal dpkg/dnf)

3Primer inicio

En el primer inicio Spendif.ai prepara el entorno — es el paso más largo, pero ocurre solo una vez.

⏱ Tiempo requerido: 5–15 minutos en una conexión doméstica típica. Espacio libre requerido: ~5 GB.
Mantén la ventana abierta hasta que desaparezca la barra de progreso.

3a. Splash + descarga del modelo de IA

Al hacer doble clic se abre una ventana nativa con una pantalla splash y barra de progreso. Spendif.ai detecta la RAM/VRAM disponible y descarga el LLM más adecuado (Qwen 2.5, Gemma 3 — tamaños de 2 a 8 GB).

El modelo se guarda en ~/.spendifai/models/ (macOS/Linux) o %APPDATA%\Spendif.ai\models\ (Windows) y sobrevive a reinstalaciones.

📷 Captura
assets/screenshots/splash-download-progress.png
(splash + progreso descarga modelo)

3b. Asistente de onboarding — 4 pasos

Cuando el modelo está listo, el splash da paso al asistente de configuración:

1. Idioma — taxonomía, formato de fecha, separadores numéricos.
2. Titulares — tu nombre y las variantes que usa tu banco.
3. Cuentas — cuenta corriente, tarjetas, efectivo.
4. Confirmar — todo se escribe solo aquí, sin persistencia parcial.

Ninguna elección es definitiva: puedes cambiar todo después desde Ajustes.

📷 Captura
assets/screenshots/onboarding-step-1-language.png
(asistente paso 1 — selección idioma)

3c. App lista

Al confirmar el asistente, Spendif.ai crea la base de datos SQLite y te lleva a la página Importar. Desde ahí cargas tus primeros CSV/XLSX bancarios.

A partir del siguiente inicio el flujo es: doble clic → splash (1-2 segundos) → app. Sin más descargas, sin más asistente.

📷 Captura
assets/screenshots/app-ready-import-page.png
(app lista, página Importar)

¿Tienes problemas?

Documentación completa: guía de instalación · guía de usuario · macOS detallada · Windows detallada.

Bugs, preguntas, solicitudes: abre una issue en GitHub.

Lo que viene a continuación

Spendif.ai está en alpha. Las funciones que añadimos se deciden junto a las personas que usan la app hoy: nada de trabajo especulativo, ninguna roadmap impuesta desde arriba.

Funciones en evaluación según los comentarios de los alpha testers:

¿Te resultaría útil alguna de estas? Dínoslo en GitHub Discussions. Cuando se acumulan suficientes peticiones sobre la misma función, sube al principio de la cola.