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

🍎

macOS

SpendifAi-*.dmg
Descargar DMG
macOS 12 Monterey o superior. Solo Apple Silicon (M1 o posterior).
¿Tienes un Mac Intel? Escríbenos: la versión para Intel no está prevista, pero basta con que alguien la pida para replantearla.
🪟

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: spendifai/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.

El DMG está firmado con un certificado Developer ID y notarizado por Apple: macOS lo abre sin advertencias.

Como alternativa, con Homebrew:

brew tap spendifai/spendifai
brew trust --cask spendifai/spendifai/spendifai
brew install --cask spendifai

A partir de ahí actualizas con brew update && brew upgrade --cask spendifai.

📷 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í.

Las primeras veces Windows puede mostrar "Windows protegió su PC": haz clic en "Más información" y luego en "Ejecutar de todas formas". El aviso desaparece a medida que el certificado acumula reputación. Detalles en 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 solo instala uv. El venv, la descarga del modelo y .env se hacen en el primer arranque, que por eso tarda unos minutos. Guía completa.

📷 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)

Desinstalar

Nada se queda en tu ordenador en contra de tu voluntad. El comando depende de cómo lo instalaste:

¿No recuerdas cómo lo instalaste? Si usaste el Terminal fue Homebrew, si no fue el DMG.

macOS, Homebrew: brew uninstall --cask spendifai

macOS, DMG: arrastra Spendif.ai.app a la Papelera

Debian / Ubuntu: sudo apt remove spendifai

Fedora / RHEL: sudo dnf remove spendifai

Windows: Configuración > Aplicaciones > Spendif.ai > Desinstalar

Tus datos se quedan, y es intencionado. En ~/.spendifai (en Windows %USERPROFILE%\.spendifai) están tu base de datos de transacciones, tus ajustes y los modelos de IA, varios GB en total. Ninguno de los comandos anteriores los toca.

Exporta lo que quieras conservar antes de borrarlo, desde la página Libro: una vez eliminado no se recupera.

Para borrar también los datos: con Homebrew, brew uninstall --zap --cask spendifai. Si no, usa el desinstalador de tu sistema (macOS, Linux, Windows), que pregunta por separado por la base de datos y por los modelos, o borra la carpeta a mano.

¿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.