Instalación

Requisitos del sistema

Ejecutar la IA en local es la parte que requiere un hardware más potente, y es opcional. Puedes desactivarla en el asistente inicial y usar EmailOps como un cliente de correo normal, o conservar todas las funciones de IA y dirigirlas a un proveedor remoto. Los dos modos tienen requisitos muy distintos.

Con IA local

Uno de los requisitos más importante para ejecutar la IA local es la memoria disponible para cargar el modelo y los contextos. Dependiendo de nuestra máquina estamos hablando de un tipo de memoria o de otro:

Regla de dimensionado: el modelo tiene que caber entero en la memoria en la que se ejecuta. El Qwen 3.5 4B predeterminado necesita unos 8 GB; el modelo más grande del catálogo pide 32 GB. La cifra de cada modelo está en el catálogo de modelos.

• Apple Silicon tiene memoria unificada — la GPU direcciona el mismo bloque que la CPU, así que la cifra a comparar es la memoria total del sistema. Un Mac de 16 GB ejecuta con holgura los modelos hasta la fila de 16 GB, restando lo que ya usan macOS y tus otras apps.
• Una GPU en Windows o Linux tiene su propia VRAM independiente, y esa es la cifra que cuenta — 32 GB de RAM del sistema no ayudan si la tarjeta solo tiene 8 GB. Un modelo que no cabe se desborda a la CPU, lo que funciona pero es varias veces más lento.
• Sin GPU también está soportado y no requiere una descarga distinta. La app recurre a la CPU y a la RAM del sistema; reserva la cifra del modelo en RAM y cuenta con respuestas notablemente más lentas.

Los Mac Intel son la excepción: esa compilación se distribuye sin el runtime de IA integrado — mira la nota más abajo.

Sin IA local

Estos son los requisitos en dos casos: con la IA desactivada del todo, y con la IA activada pero dirigida a OpenRouter. La inferencia remota ocurre en el hardware de otros, así que basta con un portátil antiguo — a cambio de una clave de API, un coste por uso y el contenido de tu correo saliendo del dispositivo. Consulta elegir un backend.

Sistema operativo

Ambos modos necesitan uno de estos:

• macOS Monterey (12) o posterior — Apple Silicon o Intel.
• Windows 10 u 11, 64 bits.
• Linux 64 bits, con WebKitGTK y un llavero Secret Service — mira Linux más abajo.

macOS

Homebrew

brew install --cask emailops/tap/emailops

Actualiza después con brew upgrade --cask emailops.

Descarga directa

1. Descarga EmailOps-macos.dmg desde la última versión.
2. Abre el DMG y arrastra EmailOps.app a tu carpeta Aplicaciones.
3. Ábrelo desde Aplicaciones.

Mac con Intel: usa la compilación EmailOps-macos-intel.dmg. No incluye el runtime de IA integrado, así que si quieres funciones de IA en un Mac Intel, apunta EmailOps a Ollama u OpenRouter.

Windows

1. Descarga EmailOps-windows.exe desde la última versión.
2. Ejecuta el instalador y sigue los pasos.
3. Abre EmailOps desde el menú Inicio.

Aceleración por GPU

No hay que instalar nada más. La versión de Windows lleva un backend Vulkan que se carga en tiempo de ejecución siempre que haya un controlador gráfico funcionando, y recurre a la CPU cuando no lo hay — la misma descarga en ambos casos.

Se eligió Vulkan en lugar de CUDA precisamente para que esto siga siendo simple: cubre AMD, Intel y NVIDIA con el controlador gráfico que ya tienes, sin ningún kit del fabricante que instalar. Mantén el controlador de la GPU razonablemente al día y funcionará.

Linux

1. Descarga EmailOps-linux.AppImage desde la última versión.
2. Dale permisos de ejecución y ábrelo:

chmod +x EmailOps-linux.AppImage
./EmailOps-linux.AppImage

Aceleración por GPU

Igual que en Windows: la AppImage lleva un backend Vulkan que se usa automáticamente cuando hay un controlador gráfico presente y recurre a la CPU cuando no lo hay. Sin kit CUDA, sin SDK del fabricante, sin tener que elegir una compilación distinta.

Lo que necesitas es el stack normal de controladores Vulkan de tu tarjeta — mesa-vulkan-drivers en AMD e Intel, el controlador propietario de NVIDIA en NVIDIA — que la mayoría de distribuciones de escritorio ya instalan. Si vulkaninfo detecta un dispositivo, EmailOps lo usará.

Hace falta un llavero

EmailOps nunca escribe las credenciales de las cuentas en un archivo: los tokens OAuth y las contraseñas IMAP van al almacén de credenciales del sistema. macOS y Windows traen uno (el Llavero y el Administrador de credenciales); en Linux tienes que aportarlo tú.

Necesitas un proveedor de Secret Service instalado y desbloqueado. Cualquiera de estos sirve:

• GNOME Keyring (gnome-keyring) — el predeterminado en GNOME, Ubuntu, Fedora Workstation.
• KWallet (kwalletmanager con la interfaz Secret Service) — el equivalente en KDE.
• KeePassXC con Ajustes → Integración con Secret Service activada.

En un gestor de ventanas mínimo o en una sesión sin escritorio a menudo no hay ningún llavero en marcha. Instala uno de los anteriores y asegúrate de que está desbloqueado cuando arranca EmailOps — de lo contrario, añadir una cuenta falla, porque no hay dónde guardar las credenciales de forma segura.

# Debian / Ubuntu
sudo apt install gnome-keyring

# Fedora
sudo dnf install gnome-keyring

# Arch
sudo pacman -S gnome-keyring

Dónde viven tus datos

Todo lo que EmailOps guarda está en tu máquina, en el directorio de datos de aplicación de tu sistema:

• Correo, contactos, eventos de calendario, embeddings — una base de datos SQLite local.
• Modelos de IA descargados — una carpeta models/ junto a la base de datos.
• Tokens OAuth y contraseñas — el llavero del sistema, nunca un archivo en claro.

Para mover o compartir un directorio de datos (para pruebas o un segundo perfil), define la variable de entorno EMAILOPS_DATA_DIR antes de arrancar. Las rutas exactas por plataforma, y qué se escribe dónde, están en Privacidad y seguridad.

Desinstalar

Quitar la app deja a propósito tu base de datos de correo y los modelos descargados, de modo que una reinstalación retoma donde lo dejaste. Borra también el directorio de datos si quieres empezar de cero.

En ningún caso se elimina nada de tu proveedor de correo — desinstalar EmailOps nunca toca el correo de Gmail, Outlook o tu servidor IMAP.

macOS

Con Homebrew, un solo comando elimina la app y sus datos:

brew uninstall --zap --cask emailops

Sin --zap solo se va la app. Para hacerlo a mano: arrastra EmailOps.app de Aplicaciones a la Papelera y luego borra:

~/Library/Application Support/com.emailops.app
~/Library/Caches/com.emailops.app
~/Library/HTTPStorages/com.emailops.app
~/Library/Preferences/com.emailops.app.plist
~/Library/Saved Application State/com.emailops.app.savedState
~/Library/WebKit/com.emailops.app

Windows

Desinstala desde Configuración → Aplicaciones → Aplicaciones instaladas → EmailOps, o ejecuta el desinstalador desde la entrada del menú Inicio. Después borra el directorio de datos:

%APPDATA%\com.emailops.app

Linux

Borra el archivo AppImage. Después borra los directorios de datos y configuración:

rm -rf ~/.local/share/com.emailops.app
rm -rf ~/.config/com.emailops.app

Credenciales guardadas

En todas las plataformas, los tokens OAuth y las contraseñas IMAP viven en el llavero del sistema y no en el directorio de datos, así que sobreviven a todo lo anterior. Elimina las entradas com.emailops.app de Acceso a Llaveros (macOS), el Administrador de credenciales (Windows) o tu gestor de llavero (Linux) si también quieres deshacerte de ellas.

Compilar desde el código fuente

Si prefieres compilarlo tú, el README del repositorio cubre la cadena de herramientas de Rust y Node, los requisitos previos de Tauri y el flujo make dev. Ten en cuenta que las compilaciones desde código necesitan tus propias credenciales OAuth de Gmail / Microsoft en .env.local; los binarios publicados ya vienen configurados.

Dos notas de compilación sobre el runtime de IA:

• Las versiones de Windows y Linux se compilan con DYNAMIC_BACKENDS=1 y CARGO_FEATURES=vulkan, que es lo que produce un único artefacto capaz de aprovechar una GPU en tiempo de ejecución. Compilar el backend Vulkan requiere el SDK de Vulkan — una dependencia solo de compilación; los usuarios nunca lo instalan.
• También existe una característica de Cargo cuda para quien quiera compilar a mano una versión específica para NVIDIA. No la usa el pipeline de publicación, así que los binarios que descargas son los de Vulkan.