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 이상 (권장 16GB / 24GB+)
약 100MB (리눅스 VM 환경 및 로컬 MLX 모델 저장용 공간 10GB~100GB 이상 추가 확보 권장)
⚡ Installation
4-1. Quick Start
brew install --cask osaurus
4-2. 상세 설치
Homebrew cask를 통해 간편하게 실행 파일을 내려받거나 공식 홈페이지 및 GitHub Release 탭에서 최신 버전의 .dmg 파일을 직접 설치할 수 있습니다.
# GUI 실행 혹은 백그라운드 서버 구동을 위한 CLI 기본 명령어
osaurus ui # Osaurus 대화형 UI 실행
osaurus serve # 로컬 백그라운드 API 서버 시작
osaurus status # 현재 에이전트 및 서버 작동 여부 확인
개발 생산성 향상을 위해 모델 콘텍스트 프로토콜(MCP) 클라이언트를 설정하려는 경우 mcpServers 설정에 아래 항목을 구성합니다.
{
"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.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.