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)。
典型使用工作流
- 选择模型——本地(如 Raptor 0.6)或云(OpenAI、Anthropic 等)。
- 创建代理——为其命名、设置提示,并可选启用文件访问、浏览器或图像生成等工具。
- 聊天——代理会记住过往交互,可调用工具,并可生成子代理处理专业任务。
- 运行代码——启用沙盒;代理编写 Markdown 待办清单,VM 执行代码,结果返回聊天。
- 持久化与共享——代理拥有加密 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;未添加任何外部假设。*
相关
- 项目
- 项目
- 项目
- 项目
- 项目