Osaurus：macOS 本地 AI 智能体框架

项目简介

Osaurus 是面向 macOS 的原生 AI harness（智能体运行框架），完全使用 Swift 编写，运行在 Apple Silicon 上，不使用 Electron。它在用户与任意模型之间，提供一层由用户自己掌控的上下文：智能体、记忆、工具与加密身份都保存在本机。使用本地模型时可完全离线工作；需要更强能力时，也可接入云端模型。除接入云端模型外，数据默认不离开 Mac。项目以 MIT 许可证开源。

主要功能

• 智能体（Agents）：每个智能体有独立的提示词、记忆和视觉主题；工具与技能会依据任务，通过 RAG 检索自动选择，无需手动配置。
• Agent Loop：自定义智能体选定工作文件夹后，获得文件、搜索与 Git 工具；开启沙箱后，还可以在隔离环境中使用 shell。模型会先写出 markdown 待办列表，再执行任务，最后给出经验证的总结。
• 沙箱：基于 Apple 的 Containerization 框架，在隔离的 Linux VM 中执行代码；其中具有 shell、Python、Node.js、编译器和包管理器等完整开发环境。每个智能体拥有独立的 Linux 用户与家目录，并通过 vsock 回连主程序以使用推理、记忆和密钥。
• 记忆：分为身份、固定事实、按会话的片段三层，并设有对话记录回退。会话结束时，系统集中提炼一次内容，按显著性打分；每次请求最多注入一段紧凑记忆，通常约 800 token 以内。
• 隐私过滤器：向云端模型发送内容前，用端侧分类器 openai/privacy-filter 识别姓名、邮箱、电话、地址、账号等，并用正则识别信用卡、AWS key、GitHub token 等；审阅预览后，把实体替换为 [PERSON_1] 之类的占位符，回复时再还原。采用 fail-closed 策略：如果替换后仍检出泄漏，就阻止发送。
• 身份：每个参与者（人、智能体、设备）都有 secp256k1 加密地址，权限从主密钥（iCloud Keychain）沿可验证的信任链逐级下放，可创建可携带的访问密钥。
• 中继与安全信道：通过 agent.osaurus.ai 的 WebSocket 隧道对外开放智能体，无需端口转发；两个 Osaurus 智能体之间使用 X25519 前向保密握手和 ChaCha20-Poly1305 端到端加密，中继只转发无法解开的密文。
• Orchestrator：内置默认智能体，可依据实时状态回答应用相关问题；修改设置前会显示审批卡片；还能并行派生子智能体，并在设定预算内汇总结果。

安装与使用

使用 Homebrew 安装：

brew install --cask osaurus

或从 Releases 下载最新 .dmg。每个版本提供两种构建：标准版约 70 MB，在引导流程中选择并下载模型；full 版约 4 GB，内置 Raptor 0.6，首次启动会把模型安装到 ~/MLXModels，安装后无需下载模型即可离线聊天，后续更新使用小体积版本。

安装后可从 Spotlight 启动，或使用命令行：

osaurus ui       # 打开聊天界面
osaurus serve    # 启动服务
osaurus status   # 查看状态

运行要求：macOS 15.5+ 与 Apple Silicon。

注意事项

• 基于 Containerization 的 Linux VM 沙箱需要 macOS 26+（Tahoe）；在更低版本上退回原生 macOS Seatbelt 沙箱，写入范围、包安装与网络访问策略都会受限。
• 智能体本地数据库默认以明文存储（由 FileVault 保护），可选择启用 SQLCipher 加密。
• 内置 Orchestrator 不提供沙箱、工作文件夹、浏览器或计算机操作能力；需要操作文件时，请创建或切换到自定义智能体，再选择文件夹。
• 智能体可通过 JSON 插件配方扩展，无需 Xcode 或代码签名。

本作品整理自 GitHub 开源项目 osaurus-ai/osaurus，原作者 @osaurus-ai，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。