osaurus-ai/osaurus

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 助手——这些代理在你的电脑上保留自己的记忆、工具和身份。该平台可与任何 LLM 通信,无论是本地存储的模型(通过 MLX、Apple Foundation Models 或 Liquid AI)还是云服务(OpenAI、Anthropic、Gemini 等)。所有编排、隐私过滤和工具调用均在设备上完成,除非你明确选择云模型,否则数据不会离开你的 Mac。

核心功能(如 README 所述)

功能 作用
代理与记忆 创建具有独立提示、持久记忆(身份、固定事实、会话片段)和视觉主题的自定义代理。每次会话后记忆会被提炼并保持紧凑。
沙盒执行 每个代理可在使用 Apple 容器化框架的隔离 Linux VM(Alpine)中运行代码,或在旧版操作系统上回退到 macOS Seatbelt 沙盒。
隐私过滤 使用设备端分类器(OpenAI 隐私过滤模型)在请求发送到云提供商前清除个人数据,采用“失败关闭”策略。
加密身份 代理和设备拥有从 iCloud Keychain 派生的 secp256k1 地址;访问密钥可进行范围控制、撤销,并用于端到端加密通信。
安全通道与中继 通过 WebSocket 隧道(agent.osaurus.ai)暴露代理,使用 X25519 握手和 ChaCha20-Poly1305 加密;中继服务器无法查看明文。
编排器 内置默认代理,可将任务委派给自定义代理或子代理,管理预算,且从不直接访问文件系统或沙盒。
子代理 为单个任务启动专用代理(本地或远程模型),通过单驻留交接以节省 RAM。
浏览器工具 每个代理可选的基于 WebKit 的浏览器,可导航、点击和输入,用户批准后执行操作,并使用隔离的 Cookie 存储。
图像生成 使用本地模型(如 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 和快捷指令。
遥测与崩溃报告 通过 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)。

典型使用工作流

  1. 选择模型——本地(如 Raptor 0.6)或云(OpenAI、Anthropic 等)。
  2. 创建代理——为其命名、设置提示,并可选启用文件访问、浏览器或图像生成等工具。
  3. 聊天——代理会记住过往交互,可调用工具,并可生成子代理处理专业任务。
  4. 运行代码——启用沙盒;代理编写 Markdown 待办清单,VM 执行代码,结果返回聊天。
  5. 持久化与共享——代理拥有加密 ID;可通过安全中继 URL 暴露以供远程访问。

适合人群

  • 希望在 macOS 上拥有私密、离线 AI 助手的高级用户。
  • 希望开发 Swift 插件或集成 macOS 应用(日历、邮件等)与 LLM 的开发者。
  • 需要设备端 AI、端到端加密和严格数据隐私保障的企业。

README 中注明的限制

  • 需要 Apple Silicon 上的 macOS 15.5+;完整 Linux VM 沙盒需要 macOS 26(Tahoe)。
  • 离线图像生成和部分重型模型需要数 GB 存储空间。
  • 某些功能(如 Apple Foundation Models)仅在最新 macOS 版本中可用。

  • 上述所有信息均直接取自项目 README;未添加任何外部假设。*

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目