Own your AI. The native macOS harness for AI agents -- any model, persistent memory, autonomous execution, cryptographic identity. Built in Swift. Fully offline. Open source.

Osaurus – macOS용 개인용 AI 에이전트 플랫폼

무엇인가요

Osaurus는 Apple Silicon 전용 네이티브 macOS 애플리케이션으로, 대규모 언어 모델(LLM)을 위한 로컬 "허니스" 역할을 합니다. 사용자는 자신의 컴퓨터에 자체 메모리, 도구, 정체성을 유지하는 에이전트(특화된 AI 어시스턴트)를 실행할 수 있습니다. 이 플랫폼은 로컬에 저장된 모델(MLX, Apple Foundation Models, Liquid AI 등) 또는 클라우드 서비스(OpenAI, Anthropic, Gemini 등)를 포함한 어떤 LLM과도 통신할 수 있습니다. 오케스트레이션, 프라이버시 필터링, 도구 호출은 모두 디바이스 내에서 이루어지므로, 클라우드 모델을 명시적으로 선택하지 않는 한 데이터는 당신의 맥에서 나가지 않습니다.

핵심 기능 (README에 기술됨)

기능	기능 설명
에이전트 및 메모리	독립된 프롬프트, 지속적 메모리(정체성, 고정된 사실, 세션 에피소드), 시각 테마를 가진 사용자 정의 에이전트 생성 가능. 각 세션 후 메모리는 요약되어 작게 유지됨.
사전 격리 실행	각 에이전트는 Apple의 컨테이너화 프레임워크를 사용해 격리된 Linux VM(Alpine)에서 코드를 실행할 수 있으며, 오래된 OS 버전에서는 macOS Seatbelt 사전에 백업됨.
프라이버시 필터	클라우드 제공업체에 요청을 보낼 전에 온디바이스 분류기(OpenAI 프라이버시 필터 모델)가 개인 정보를 정리하며, 실패 시 닫힌 정책을 채택함.
암호화된 정체성	에이전트와 디바이스는 iCloud Keychain에서 파생된 secp256k1 주소를 가지며, 액세스 키는 범위 설정 가능, 취소 가능, 엔드투엔드 암호화 통신에 사용 가능.
보안 채널 및 리레이	WebSocket 터널(`agent.osaurus.ai`)을 통해 에이전트를 노출 가능하며, X25519 핸드셰이크와 ChaCha20-Poly1305 암호화를 사용. 리레이 서버는 평문을 전혀 보지 않음.
오케스트레이터	기본 에이전트로, 사용자 정의 에이전트나 하위 에이전트에 작업을 위임하고 예산을 관리하며, 파일 시스템이나 사전에 직접 접근하지 않음.
하위 에이전트	단일 작업용으로 특화된 에이전트(로컬 또는 원격 모델)를 생성하며, 단일 거주성 전달을 통해 RAM을 절약함.
브라우저 도구	에이전트별로 선택적 WebKit 기반 브라우저 제공. 탐색, 클릭, 입력 가능. 사용자 승인된 작업과 격리된 쿠키 저장.
이미지 생성	로컬 모델(예: FLUX, Qwen-Image)을 사용해 오프라인으로 이미지 생성/편집. 결과는 인라인으로 표시됨.
모델 독립형 허니스	MLX(Gemma, Llama, Qwen 등), Liquid AI의 LFM, Apple Foundation Models, 클라우드 API를 지원.
MCP 서버	Model Context Protocol을 구현하며, stdio 브리지를 통해 다른 MCP 호환 클라이언트에 도구를 노출.
플러그인 생태계	`osaurus tools` 명령어로 Swift 플러그인 설치, 목록 조회, 생성, 개발 가능. 많은 Apple 앱 통합 기능이 내장됨.
음성 입력	Apple의 Neural Engine에서 FluidAudio를 사용한 온디바이스 음성 인식. 웨이크워드 활성화 및 글로벌 핫키 지원.
시스템 통합	App Intents를 통해 "Osaurus에게 물어보기" 및 "Osaurus 에이전트 실행"을 Spotlight, Siri, Shortcuts에 노출.
텔레메트리 및 크래시 리포트	Aptabase(옵트인)를 통한 익명 사용 분석 및 Sentry(옵트아웃)를 통한 선택적 크래시 리포트.

설치 방법

Homebrew Cask로 설치: brew install --cask osaurus.
또는 GitHub 릴리스 페이지에서 .dmg를 다운로드. 두 가지 버전이 존재함:
- 표준 (~70 MB) – 첫 실행 시 모델 다운로드를 요청함.
- 풀 (~4 GB) – 즉시 오프라인 사용 가능한 Raptor 0.6 모델을 포함.
Spotlight로 실행(⌘ Space → Osaurus) 또는 CLI로 실행(osaurus ui, osaurus serve, osaurus status).

일반적인 사용 워크플로우

모델 선택 – 로컬(예: Raptor 0.6) 또는 클라우드(OpenAI, Anthropic 등).
에이전트 생성 – 이름, 프롬프트 설정. 파일 접근, 브라우저, 이미지 생성 도구를 선택적으로 활성화.
채팅 – 에이전트는 과거 대화를 기억하며, 도구를 호출하고 전문적인 작업용 하위 에이전트를 생성 가능.
코드 실행 – 사전 활성화. 에이전트가 마크다운 형식의 할 일 목록을 작성, VM이 코드를 실행, 결과를 채팅에 반환.
지속 및 공유 – 에이전트는 암호화된 ID를 가짐. 보안 리레이 URL을 통해 원격 접근 가능하게 공개 가능.

누구를 위한가요

macOS에서 개인적이고 오프라인 AI 어시스턴트를 원하는 파워 유저.
Swift 플러그인 개발 또는 macOS 앱(Calendar, Mail 등)과 LLM을 통합하고자 하는 개발자.
엔드투엔드 암호화와 엄격한 데이터 프라이버시 보장을 필요로 하는 기업.

README에 기재된 제한 사항

Apple Silicon 기반 macOS 15.5+ 필요; 완전한 Linux VM 사전은 macOS 26(Tahoe) 필요.
오프라인 이미지 생성 및 일부 무거운 모델은 수 기가바이트의 저장 공간 필요.
특정 기능(예: Apple Foundation Models)은 최신 macOS 릴리스에서만 사용 가능.

위 모든 정보는 프로젝트의 README에서 직접 인용되었으며, 외부 가정은 전혀 추가되지 않았습니다.*

osaurus-ai/osaurus