Publicada el · Actualizada el
Osaurus el runtime nativo de macOS para agentes de IA
Osaurus convierte tu Mac en una capa local para que agentes de IA trabajen con memoria persistente, herramientas nativas y enrutado entre modelos locales y en la nube. Esta ficha explica qué te llevas con él, para quién merece la pena y por qué el resto de opciones se quedan cortas.
Lo que hay dentro, de principio a fin
La idea aprovechable una capa de sistema para tus agentes
El movimiento interesante de Osaurus no es el icono de dinosaurio en la barra de menús, sino el concepto: tratar el silicio del Mac como una capa de operación para agentes, no como un simple chat offline.
En la práctica eso significa tres cosas concretas que merece la pena llevarte a tu próximo proyecto, uses Osaurus o no:
Osaurus se sitúa entre tus agentes y los modelos, expone una pasarela HTTP local que habla los protocolos de OpenAI, Anthropic y Ollama a la vez. Tu IDE (Cursor, Claude Code, scripts de LangChain) apunta a http://127.0.0.1:8080/v1 y hereda memoria persistente, carpetas de trabajo con permisos y enrutado entre local y nube.
Los agentes creados en Osaurus recuerdan entre sesiones porque su memoria vive en tu Mac, no en una pestaña de navegador que se cierra al día siguiente. Puedes otorgarles permisos de lectura y escritura sobre carpetas concretas de proyecto.
Frente a los grabadores de macros que secuestran el cursor, los plugins de Osaurus (como osaurus-macos-use) mueven aplicaciones nativas mediante SkyLight y CoreGraphics sin tocar tu foco ni tus espacios virtuales.
La capa local es la pieza. Si solo quieres probar modelos, te basta con LM Studio u Ollama; lo que diferencia a Osaurus es que envuelve esos modelos con memoria, herramientas y una pasarela unificada.
Por qué el “cómo” se queda corto comparación con alternativas reales
El original describe Osaurus frente a ChatGPT Desktop y Claude Desktop y lo presenta como un competidor. La realidad es más matizada: Osaurus no compite con un chat de escritorio, sino que opera un escalón por debajo, como infraestructura para tus propios agentes. Frente a sus vecinos naturales (MindMac, LM Studio, Msty), cada uno cubre un trozo del problema y Osaurus intenta unirlos.
| Herramienta | Qué hace bien | Qué le falta frente a Osaurus |
|---|---|---|
| MindMac | Cliente nativo de chat multi-modelo con interfaz pulida para prompts, formato de código y gestión de historiales. | No es un runtime de agentes: carece de memoria persistente entre sesiones y de automatización de escritorio. |
| LM Studio | Descubrimiento, descarga y ejecución local de modelos GGUF/MLX con servidor local compatible con OpenAI. | No actúa como capa de operación: no tiene memoria persistente entre proveedores, ni rutinas programadas, ni herramientas de visión o navegación. |
| Msty | Espacio offline-first para combinar modelos locales y nube, con bibliotecas de prompts y RAG sobre documentos locales. | Está orientado a gestión personal del conocimiento, no a alimentar agentes desarrolladores, flujos CLI o herramientas de código externas mediante una pasarela unificada. |
Si tu objetivo es solo conversar con un modelo local, cualquiera de los tres anteriores cumple. Si necesitas que ese modelo ejecute tareas, recuerde entre sesiones y mueva archivos o ventanas, ahí entra Osaurus.
Puesta en marcha en cinco pasos lo mínimo viable
Estos son los pasos del original, condensados al recorrido útil para tener un agente conectado a tu IDE:
Descarga el .dmg desde osaurus.ai o la página de Releases del repositorio y arrastra Osaurus a la carpeta Aplicaciones. Si Gatekeeper protesta, ejecuta xattr -cr /Applications/Osaurus.app para limpiar la cuarentena.
# Alternativa: clonar y compilar desde fuente
git clone https://github.com/osaurus-ai/osaurus.git
cd osaurus
open /Applications/Osaurus.appAbre el icono de dinosaurio en la barra de menús, entra en Ajustes y en la pestaña Models añade un modelo local MLX (Qwen, Llama) o conecta una instancia ya en marcha de Ollama o LM Studio. En la pestaña Providers pega las claves de Anthropic, OpenAI, Gemini u OpenRouter para tener caída a la nube.
Abre Terminal y descarga los plugins verificados desde el registro de herramientas:
osaurus tools install osaurus.time
osaurus tools install osaurus.fetch
osaurus tools install osaurus.browser
osaurus tools install osaurus.vision # OCR y eliminación de fondoEn la sección Agents del panel, pulsa + New Agent con una configuración del estilo:
| Campo | Valor de ejemplo |
|---|---|
| Nombre | Codebase Refactor & Documentation Lead |
| Modelo | Anthropic Claude 3.5 Sonnet (o Qwen-2.5-Coder-32B local) |
| Carpeta de trabajo | /Users/usuario/Proyectos/mi-app |
| Herramientas activas | osaurus.fetch, osaurus.browser, file_system_read_write |
| Memoria persistente | Activada |
Asegúrate de que la pasarela está en marcha (puerto por defecto 8080 u 11434) y redirige tu entorno de código hacia Osaurus:
export OPENAI_BASE_URL="http://127.0.0.1:8080/v1"
export OPENAI_API_KEY="sk-osaurus-local-session"
curl http://127.0.0.1:8080/v1/modelsSi curl devuelve la lista de modelos, tu IDE ya hereda memoria persistente y enrutado local/nube sin más cambios.
Fallos típicos y arreglo rápido el parte de guerra
| Error | Qué significa | Cómo se arregla |
|---|---|---|
| Gatekeeper bloquea la app o un plugin sin firmar | macOS impide ejecutar .dmg recién descargados o .dylib no firmados. | Ajustes del Sistema > Privacidad y Seguridad > Abrir de todos modos, o xattr -cr /Applications/Osaurus.app en Terminal. |
| Permiso de Accesibilidad denegado | Un agente o plugin (osaurus-macos-use) intenta mover ventanas sin autorización del sistema. | Ajustes del Sistema > Privacidad y Seguridad > Accesibilidad y activa el interruptor para Osaurus (y para tu Terminal si lo lanzas por CLI). |
| Puerto 8080 u 11434 ya en uso | Otra app (Ollama, Docker) ocupa el puerto de la pasarela local. | Cambia el puerto en Preferencias > API Gateway (por ejemplo a 8088 o 8642) o cierra el proceso en conflicto. |
| El modelo no carga o salta OOM | Falta RAM/VRAM libre en el chip para cargar los pesos MLX junto al resto de apps. | Cambia a una cuantización más agresiva (Q4_K_M en vez de FP16), cierra apps pesadas o deriva esa tarea a la nube. |
zsh: command not found: osaurus | El binario CLI no se enlazó al PATH durante la instalación gráfica. | sudo ln -s /Applications/Osaurus.app/Contents/MacOS/osaurus /usr/local/bin/osaurus |
Los dos primeros fallos son los más comunes la primera vez y se resuelven siempre desde Ajustes del Sistema, no tocando archivos a mano.