프로젝트 소개

Osaurus는 AI 에이전트를 위한 로컬 하네스 역할을 하는 네이티브 macOS 애플리케이션으로, Apple Silicon용 Swift로 작성되었으며 MIT 라이선스로 배포됩니다. 사용자와 로컬 또는 클라우드 모델 사이에 위치하며 컨텍스트, 메모리, 도구, 신원을 사용자 머신에 유지합니다. README에 설명된 핵심 기능: - 에이전트: 각 에이전트는 자체 프롬프트, 메모리, 테마를 가집니다. 도구와 스킬은 RAG 검색을 통해 자동으로 선택됩니다. 사용자 정의 에이전트는 선택한 작업 폴더로 에이전트 루프를 실행하여 파일, 검색, git 도구와 선택적 샌드박스 셸 액세스를 얻을 수 있습니다. 내장 Orchestrator는 앱에 대한 질문에 답하고, 승인 카드 뒤에서 설정 변경을 계획하며, 하위 에이전트에 작업을 위임합니다. - 샌드박스: 에이전트는 Apple의 Containerization 프레임워크를 사용하여 격리된 Linux VM에서 코드를 실행하며, 에이전트별 Linux 사용자와 호스트로 돌아가는 vsock 브리지를 갖춥니다. 이전 macOS 버전에서는 네이티브 Seatbelt 샌드박스로 폴백합니다. - 메모리: 세 계층(신원, 고정 사실, 세션별 에피소드)과 트랜스크립트 폴백, 중요도 점수 및 백그라운드 통합을 제공합니다. - 프라이버시 필터: 온디바이스 분류기와 정규식이 클라우드 모델로 전송하기 전에 이름, 이메일, 전화번호, URL, 주소, 날짜, 계좌번호, 비밀을 감지하여 플레이스홀더로 대체하고 스트리밍된 응답을 복원합니다. fail-closed로 설명됩니다. - 신원 및 보안 채널: 참가자를 위한 secp256k1 주소, 마스터 키로부터의 권한 체인, 휴대용 액세스 키, X25519와 ChaCha20-Poly1305를 사용한 종단간 암호화 에이전트 간 통신. - 릴레이: 에이전트별 URL로 WebSocket 터널을 통해 에이전트를 노출합니다. - 모델: Gemma, Qwen, GPT-OSS, Llama와 같은 계열을 위한 로컬 MLX 추론; Liquid AI LFM 지원; macOS 26+의 Apple Foundation Models; OpenAI, Anthropic, Gemini, xAI/Grok, Venice AI, OpenRouter, Ollama, LM Studio, Osaurus Router를 포함한 클라우드 제공자. - MCP: Osaurus는 MCP 서버(`osaurus mcp` stdio 브리지 경유)이자 OAuth 2.1로 원격 URL 기반 MCP 제공자를 집계할 수 있는 MCP 클라이언트입니다. - 도구 및 플러그인: 플러그인 설치, 목록화, 생성, 개발을 위한 CLI; 내장 Apple 앱 도구(Calendar, Reminders, Contacts, Notes, Mail, Messages, Maps, Music, Shortcuts); Vision, XLSX, PPTX, Images, Telegram, Resend, Fetch 등을 위한 네이티브 플러그인. - 추가 기능: GitHub에서 가져올 수 있는 스킬과 메서드, 예약 자동화 및 폴더 감시자, 온디바이스 음성 전사, Shortcuts/Spotlight/Siri용 App Intents, 에이전트별 WebKit 세션을 사용한 브라우저 사용, 오프라인 이미지 생성, 서버 탐색 및 추론 모니터링을 위한 개발자 도구. 호환성: localhost 포트 1337에서 OpenAI, Anthropic, Ollama 호환 엔드포인트를 제공하며 스트리밍 도구 호출 델타를 지원합니다. 설치는 Homebrew cask 또는 DMG를 통해 이루어지며 macOS 15.5+ 및 Apple Silicon이 필요합니다. 텔레메트리는 익명 사용 분석을 위해 Aptabase(소스 빌드에서는 꺼짐)를, 충돌 보고를 위해 Sentry(옵트아웃 가능)를 사용합니다.