Saltar al contenido
Taveras Solutions · Ir al inicio
Agendar diagnóstico

MIT (el nombre y el logo de ModelNap están reservados)App para macOS

ModelNap

Una app de barra de menú que duerme tus modelos locales de Ollama y te devuelve la memoria del Mac.

Un modelo local de 20 a 30 GB se queda ocupando RAM aunque no lo uses. ModelNap lo descarga cuando está inactivo y enciende o apaga Ollama con un clic, sin Terminal.

Estrellas
24
Forks
3
Lenguaje
Swift
Licencia
MIT (el nombre y el logo de ModelNap están reservados)
Panel de ModelNap abierto desde la barra de menú junto a sus ajustes: Ollama encendido, un modelo en memoria que se libera en 23 minutos y la memoria del Mac
292
descargas del instalador .dmg (v1.2.1 y v1.3.0)
13 días
de la v1.0.0 a la v1.3.0, con 5 versiones publicadas
14
pruebas automáticas de la detección de inactividad, corridas en GitHub Actions
24
estrellas en GitHub y 3 forks

El reto

Correr IA en tu propio Mac tiene un costo escondido: un modelo de 20 a 30 GB se queda ocupando la memoria aunque nadie le esté preguntando nada. El resto del día el equipo va lento y la única salida era abrir la Terminal.

Apagar Ollama tampoco era simple. Depende de cómo se instaló, y si se hace por la vía equivocada macOS lo vuelve a arrancar solo. Además, Ollama no dice cuándo fue la última petición, así que no había una forma directa de saber que el modelo estaba ocioso.

Lo que construimos

Construimos una app de barra de menú en Swift (AppKit y SwiftUI) que enciende y apaga Ollama con un clic o con el atajo ⌥⌘O. Detecta si Ollama viene de Ollama.app, de brew services, de un LaunchAgent propio o de un ollama serve manual, y lo detiene por esa misma vía para que no reviva.

Para saber si el modelo está ocioso medimos antes de programar: con gemma4 26B en un Apple M5 Pro, el proceso del modelo gasta 0,06 s de CPU en 30 s de reposo y 0,99 s al generar 104 tokens. Con ese dato, la app suma cada 2,5 s el tiempo de CPU y, tras 5, 15, 30 o 60 minutos sin actividad, descarga el modelo. Ollama sigue encendido y lo recarga con el siguiente mensaje.

También probamos la App Store y la descartamos con datos: con el sandbox activo, launchctl responde Bad request y las señales a otros procesos fallan. Por eso ModelNap se distribuye firmada con Developer ID y notarizada por Apple, como binario universal para Apple Silicon e Intel, sin cuentas ni telemetría.

Cómo se ve

Panel de ModelNap en español: Ollama encendido, barra de memoria del Mac con 31,6 de 48 GB y la lista de modelos instalados
El panel: cuánta memoria ocupa el modelo, cuándo se libera y un botón para liberarlo ya.
Ajustes de ModelNap en inglés: liberar el modelo tras 30 minutos, con qué encender Ollama, opciones de Splash, atajo de teclado e idioma
Ajustes por motor: Ollama y Splash tienen cada uno su propio tiempo de reposo.
Ventana del instalador: arrastrar ModelNap a Aplicaciones, con la nota de que está firmada y notarizada por Apple
Instalador firmado y notarizado: se abre sin avisos de Gatekeeper.
Tres estados del icono en la barra de menú: encendido con punto verde, arrancando o deteniendo con punto ámbar, y apagado
El estado de Ollama de un vistazo, sin abrir nada.

PARA QUIÉN SIRVE

  • Profesionales y equipos que corren modelos de IA locales en un Mac por privacidad o costo, y necesitan esa memoria para el resto de su trabajo.
  • Quien usa Ollama o Splash sin querer abrir la Terminal para encenderlos, apagarlos o saber qué está cargado.
  • Desarrolladores que buscan un ejemplo de app nativa para macOS compilada con swiftc sin proyecto de Xcode, firmada y notarizada, con licencia MIT.

QUÉ HACE

  • Enciende y apaga Ollama desde el panel o con el atajo global ⌥⌘O.
  • Detecta si Ollama viene de Ollama.app, brew services, un LaunchAgent propio u ollama serve, y lo detiene por la misma vía.
  • Libera el modelo tras 5, 15, 30 o 60 minutos sin generar; Ollama sigue encendido y lo recarga con el siguiente mensaje.
  • Muestra la RAM en uso, cuánto ocupa el modelo y la presión de memoria del sistema.
  • Controla también Splash: lo enciende, lee su memoria real desde /status y lo detiene cuando está inactivo.
  • En inglés y español, firmada y notarizada por Apple, sin cuentas ni telemetría.

Cómo está armado

  1. App de barra de menú AppKit y SwiftUI compilados directo con swiftc, sin proyecto de Xcode.
  2. Detección del mecanismo Ollama.swift busca Ollama.app, un LaunchAgent cargado o ollama serve, y usa launchctl o señales según el caso.
  3. Detección de inactividad Cada 2,5 s suma el tiempo de CPU de los procesos ollama runner; si sube más de 0,08 s cuenta como actividad.
  4. Memoria del Mac SystemMemory.swift calcula la RAM en uso como el Monitor de Actividad y lee la presión del sistema.
  5. Distribución package.sh firma con hardened runtime, notariza y engrapa la app y el .dmg; GitHub Actions compila cada cambio.

Stack

SwiftSwiftUImacOSOllama

Por qué lo hicimos

Sale de medir antes de construir: el tiempo de CPU de los runners para detectar inactividad y el sandbox de la App Store para descartarla. Es una app nativa de Taveras Solutions, de la idea a la notarización.

Cómo empezar

Descarga el .dmg desde github.com/eriktaveras/modelnap/releases/latest
Arrastra ModelNap a Aplicaciones y ábrela: aparece en la barra de menú
Para compilar: ./build.sh
Para correr las pruebas de IdleTracker: ./build.sh --test

LO QUE APRENDIMOS

  • Medir antes de programar: el tiempo de CPU del proceso del modelo resolvió algo que la API de Ollama no da. Con Splash el truco no servía, porque genera en la GPU y casi no usa CPU, así que ahí contamos peticiones desde su /status.
  • Cada forma de instalación necesita su propia forma de apagar. Ollama.app 0.34 rechaza el pedido de cierre de otra app, y apagarla tardaba 10 s y terminaba forzada; con SIGTERM a los 2 s cierra limpio en unos 2,3 s.
  • No toda app de Mac cabe en la App Store. Probar el sandbox antes de diseñar la distribución nos ahorró construir para un canal que no permite controlar otros procesos.

Necesitas algo así a la medida?

Usamos estas mismas herramientas en los proyectos de nuestros clientes.