Osaurus
Osaurus is a macOS native artificial intelligence agent execution and management runtime harness, fully optimized for Apple Silicon hardware. Just as a smartphone's operating system acts as a central control unit that runs various mobile apps and precisely allocates device resources, Osaurus serves as a control center and execution engine, enabling local and cloud large language models to safely interact with the user's Mac system files and development tools. It is released as a fully open-source project under the MIT license and is commonly used.
Osaurus is a macOS native artificial intelligence agent execution and management runtime harness, fully optimized for Apple Silicon hardware. Just as a smartphone's operating system acts as a central control unit that runs various mobile apps and precisely allocates device resources, Osaurus serves as a control center and execution engine, enabling local and cloud large language models to safely manipulate the user's Mac system files and development tools. It is released as a complete open-source project under the MIT license, meticulously excluding the commonly used, heavy Electron wrapper and compiled solely in pure Swift, harmonizing with Apple's latest graphics and computation APIs. This minimizes the Mac's hardware resource usage and provides extremely responsive user interaction.
Existing simple model execution clients have demonstrated clear limitations in safely controlling a practical working environment, such as allowing the agent to directly write code and execute system-internal commands, relying solely on the text inference performance of large language models. To address this technical need, Osaurus introduces a unique Linux virtual machine (VM)-based sandbox architecture leveraging Apple's Containerization Framework. This creates a complete agent loop where the agent repeatedly installs packages, compiles, and executes scripts within a virtual environment, completely isolated to prevent any harm to the host macOS system. Furthermore, it presents a robust offline security pipeline through an on-device privacy filter that operates within the device, detecting and masking sensitive information such as names, emails, phone numbers, system passwords, and API tokens locally before transmitting them to the server, even when using external commercial cloud models.
For researchers and developers in various domains, including computer science and life sciences, Osaurus is a useful tool that tirelessly and autonomously performs the roles of a powerful offline assistant and secretary. By fully adopting the Model Context Protocol (MCP), it allows users to instantly combine over 20 external productivity service APIs, such as Notion, Linear, GitHub, and Stripe, with just a few mouse clicks. It can also be combined with macOS native plugins, such as email, calendar, and document viewers, to independently plan and execute complex multi-step tasks. Additionally, it features a Watcher function that monitors specific folders in the local repository in real-time, along with a three-tiered intelligent RAG knowledge retrieval memory layer divided into Session Memory and Pinned Facts. This ensures that whenever a new file or paper is detected, only the core information is extracted and accumulated in long-term memory without unnecessary token waste, allowing the user to complete designated automated tasks perfectly even while they are asleep or away.
💻 System Requirements
Apple Silicon Unified Memory 8GB or higher (recommended 16GB / 24GB+)
Approximately 100MB (additional space of at least 10GB~100GB is recommended for Linux VM environment and local MLX model storage)
⚡ Installation
4-1. Quick Start
brew install --cask osaurus
4-2. Detailed installation
You can easily download the executable file via Homebrew Cask, or directly install the latest version of the .dmg file from the official website and GitHub Release tab.
# Basic CLI commands for running the GUI or starting the background server
osaurus ui # Run Osaurus interactive UI
osaurus serve # Start local background API server
osaurus status # Check whether agents and servers are currently operational.
To improve development productivity, if you want to set up a Model Context Protocol (MCP) client, configure the following items in the mcpServers setting.
{
"mcpServers": {
"osaurus": {
"command": "osaurus",
"args": ["mcp"]
}
}
}
FAQ
What is Osaurus?
Osaurus is a macOS native artificial intelligence agent execution and management runtime harness, fully optimized for Apple Silicon hardware. Just as a smartphone's operating system acts as a central control unit that runs various mobile apps and precisely allocates device resources, Osaurus serves as a control center and execution engine, enabling local and cloud large language models to safely manipulate the user's Mac system files and development tools. It is released as a complete open-source project under the MIT license, meticulously excluding the commonly used, heavy Electron wrapper and compiled solely in pure Swift, harmonizing with Apple's latest graphics and computation APIs. This minimizes the Mac's hardware resource usage and provides extremely responsive user interaction. Existing simple model execution clients have demonstrated clear limitations in safely controlling a practical working environment, such as allowing the agent to directly write code and execute system-internal commands, relying solely on the text inference performance of large language models. To address this technical need, Osaurus introduces a unique Linux virtual machine (VM)-based sandbox architecture leveraging Apple's Containerization Framework. This creates a complete agent loop where the agent repeatedly installs packages, compiles, and executes scripts within a virtual environment, completely isolated to prevent any harm to the host macOS system. Furthermore, it presents a robust offline security pipeline through an on-device privacy filter that operates within the device, detecting and masking sensitive information such as names, emails, phone numbers, system passwords, and API tokens locally before transmitting them to the server, even when using external commercial cloud models. For researchers and developers in various domains, including computer science and life sciences, Osaurus is a useful tool that tirelessly and autonomously performs the roles of a powerful offline assistant and secretary. By fully adopting the Model Context Protocol (MCP), it allows users to instantly combine over 20 external productivity service APIs, such as Notion, Linear, GitHub, and Stripe, with just a few mouse clicks. It can also be combined with macOS native plugins, such as email, calendar, and document viewers, to independently plan and execute complex multi-step tasks. Additionally, it features a Watcher function that monitors specific folders in the local repository in real-time, along with a three-tiered intelligent RAG knowledge retrieval memory layer divided into Session Memory and Pinned Facts. This ensures that whenever a new file or paper is detected, only the core information is extracted and accumulated in long-term memory without unnecessary token waste, allowing the user to complete designated automated tasks perfectly even while they are asleep or away.
When should I use Osaurus?
Osaurus is a macOS native artificial intelligence agent execution and management runtime harness, fully optimized for Apple Silicon hardware. Just as a smartphone's operating system acts as a central control unit that runs various mobile apps and precisely allocates device resources, Osaurus serves as a control center and execution engine, enabling local and cloud large language models to safely interact with the user's Mac system files and development tools. It is released as a fully open-source project under the MIT license and is commonly used.
📝 Update Notes
- v0.25.2610/25/2026
이번 업데이트는 앱의 UI 프리징 현상을 해결하는 대규모 버그 수정을 통해, 대용량 생물학적 데이터를 처리할 때의 작업 안정성을 크게 높였습니다. 특히 에이전트 템플릿과 번들 임포트 기능이 추가되어, 복잡한 실험 분석 워크플로우나 프롬프트를 팀원들과 손쉽게 공유하고 재사용할 수 있게 되었습니다. 또한 새로운 런타임 지원과 보안 강화로 더욱 다양한 AI 모델을 활용해 민감한 연구 데이터를 더욱 안전하고 효율적으로 분석할 수 있습니다.
- v0.25.2310/19/2026
이번 업데이트에서는 이미지 배치 처리와 비디오 제어 기능이 강화되어, 대량의 현미경 사진이나 실험 영상을 더욱 효율적으로 관리하고 분석할 수 있습니다. 특히 Nemotron 3.5 Super-VL 등 최신 모델의 도입으로 시각적 추론 능력이 향상되어, 복잡한 생물학적 이미지 데이터에 대한 정밀한 해석이 가능해졌습니다. 또한 이미지 워크플로우 파라미터를 보존하는 기능이 추가되어, 실험 데이터 분석의 재현성을 확보하려는 연구원들에게 매우 유용한 업데이트가 될 것입니다.
- v0.25.2110/13/2026
Qwen-Image-2.1-Turbo 지원 등 멀티모달 기능이 강화되어 실험 이미지나 구조 분석 데이터를 처리하기 더욱 정교해졌어요. 특히 파일 쓰기 기능의 글자 수 제한이 제거되어, 긴 DNA 서열이나 대용량의 실험 로그를 끊김 없이 다룰 수 있게 되었습니다. 또한 워크북 편집 시 수식과 형식이 유지되므로, 실험 데이터의 무결성을 유지하며 AI와 함께 분석 작업을 수행하기에 매우 유용한 업데이트입니다.
- v0.25.1910/7/2026
Osaurus 0.25.19 버전에서는 대화 중 메시지 처리 방식이 개선되어, 작업이 진행 중일 때도 실시간으로 새로운 지시를 전달할 수 있게 되었습니다. 이를 통해 복잡한 생물학적 데이터 분석 과정에서 흐름을 끊지 않고 즉각적인 피드백을 반영할 수 있어 연구 효율이 높아집니다. 또한, 매 실행마다 새로운 채팅 세션을 시작하여 실험 결과의 재현성을 높였으며, 메시지 누락 방지를 위한 큐잉 기능도 강화되었습니다. 마지막으로 모델이 포함된 오프라인 버전도 제공되어, 보안이 중요한 민감한 생명공학 데이터를 외부 유출 걱정 없이 안전하게 처리할 수 있습니다.
- v0.25.1610/2/2026
이번 Osaurus 0.25.16 업데이트는 프로그램의 안정성을 높이고 사용자 인터페이스를 직관적으로 개선하는 데 집중했습니다. 특히 런타임 충돌 문제를 해결하여, 복잡한 데이터를 처리하거나 모델을 구동하는 연구 과정에서 발생할 수 있는 갑작스러운 중단 위험을 줄였습니다. 또한 모델 선택기와 설정 메뉴의 UI를 재설계하여, 연구자가 다양한 AI 도구와 모델을 더욱 빠르고 편리하게 관리하며 실험에 몰입할 수 있도록 돕습니다.
- v0.25.149/27/2026
이번 업데이트에서는 iOS 앱 연동 기능이 추가되어, 실험실 밖에서도 모바일로 편리하게 AI 에이전트를 활용할 수 있습니다. 특히 채팅 기록을 다시 불러올 때 생성 지표(generation metrics)가 유지되도록 개선되어, 연구 데이터의 일관성을 추적하고 관리하기가 더욱 수월해졌습니다. 또한 에이전트의 목적과 설명이 일관되게 표시되도록 수정되어, 반복적인 프롬프트 수정 과정에서도 실험 설계의 정확도를 높일 수 있습니다.
- v0.25.129/23/2026
Osaurus 0.25.12 업데이트는 연구 자동화 과정의 안정성과 신뢰도를 높이는 데 중점을 두었습니다. 핵심 AI 모델이 응답하지 않을 경우 다른 모델로 자동 전환되는 기능이 추가되어, 대규모 데이터 분석 중 발생할 수 있는 작업 중단 위험을 줄였습니다. 또한 자동화 권한 확인 로직이 개선되어, 다양한 환경에서도 오류 없이 더욱 정교하고 견고한 자동화 워크플로우를 운영할 수 있습니다.
- v0.25.79/18/2026
Bonsai2 런타임 지원과 Qwen 템플릿 보존 기능이 추가되어, 복잡한 생물학적 데이터 분석을 위한 AI 에이전트의 도구 활용 능력이 더욱 정교해졌습니다. 특히 채팅 및 에이전트 히스토리에서 MCP 이미지 결과가 안정적으로 유지되도록 개선되어, 실험 이미지와 같은 시각적 분석 데이터를 연구 기록에서 놓치지 않고 확인할 수 있습니다. 또한 워크스페이스 안내 방식과 UI 레이아웃 버그가 수정되어, 여러 연구 프로젝트를 동시에 관리할 때의 작업 흐름이 더욱 매끄러워졌습니다.
- v0.25.39/14/2026
Osaurus 0.25.3 업데이트에서는 앱을 다시 실행해도 기존 채팅 탭이 유지되어, 긴 호흡이 필요한 생명공학 데이터 분석 흐름을 끊김 없이 이어갈 수 있어요. n8n을 활용한 보안 채널 설정과 로컬 비전 입력 기능의 개선으로, 외부 데이터와의 안전하고 정밀한 연동 및 이미지 분석이 더욱 용이해졌습니다. 또한 채팅 히스토리 오류 수정과 앱 안정성 향상을 통해, 연구 기록을 더욱 신뢰성 있게 관리할 수 있게 되었답니다.
- v0.22.127/28/2026
Osaurus 0.22.12 업데이트는 주로 시스템 안정성 강화와 사용자 인터페이스(UI) 최적화에 집중했습니다. 특히 도구 호출(tool calls) 과정의 디코딩 오류와 앱 멈춤 현상을 해결하여, 복잡한 데이터 분석 워크플로우를 수행할 때 발생할 수 있는 중단 위험을 줄였습니다. 또한 네트워크 호출 구조 개선과 채팅 가독성 향상을 통해 연구자가 분석 결과를 더욱 명확하고 쾌적하게 모니터링할 수 있도록 돕습니다. 실험 데이터 처리 자동화 등 안정적인 작업 환경이 중요한 연구원이라면 이번 업데이트를 적용해 보시는 것을 추천합니다.
- v0.22.107/24/2026
What's Changed
- Remove binary prefill proof artifacts (#2135) by @jjang-ai
- Fix Bonsai DB recovery and SSD prefix reuse (#2153) by @jjang-ai
- Fix TextEdit AppleScript state and completion handling (#2151) by @jjang-ai
- Fix tool finalization and SSD cache warmup (#2146) by @jjang-ai
🚀 Features
- auto generate chat titles (#2144) by @RaajeevChandran
- group consecutive thinking and tool activity into one expandable row (#2142) by @RaajeevChandran
🐛 Bug Fixes
- fix settings window
🧪 Related Code of Life
No related Code of Life posts yet.