Osaurus

拥有你的 AI。
Agent、记忆、工具和身份都运行在你的 Mac 上。纯 Swift 构建。完全离线。开源。

下载 Mac 版 · 文档 · 模型 · Discord · Twitter · 插件注册表

## 推理就是你所需要的一切。其他一切都可以为你所拥有。 模型正变得越来越便宜且日益可互换。不可替代的是围绕它们的层——你的上下文、你的记忆、你的工具、你的身份。其他人将这一层保留在他们的服务器上。Osaurus 将其保留在你的机器上。 Osaurus 是专为 macOS 打造的 AI 驱动器。它位于你和任何模型（本地或云端）之间，并提供使 AI 个性化的连续性：能够记忆、自主执行、运行真实代码且可从任何地方访问的 Agent。模型是可互换的，而驱动器才是不断积累价值的关键。 完全支持离线使用本地模型。当你需要更强大的算力时，可以连接到任何云服务商。除非你主动选择，否则不会有任何数据离开你的 Mac。 在 Apple Silicon 上原生运行 Swift。不使用 Electron。绝不妥协。MIT 许可证。 ## 安装 ``` brew install --cask osaurus ``` 或者从 [Releases](https://github.com/osaurus-ai/osaurus/releases/latest) 下载最新的 `.dmg`。安装后，从 Spotlight（`⌘ Space` → “Osaurus”）或 CLI 启动： ``` osaurus ui # Open the chat UI osaurus serve # Start the server osaurus status # Check status ``` ## Agent Agent 是 Osaurus 的核心。每个 Agent 都有自己的提示词、记忆和视觉主题——研究助手、编码伙伴、文件整理器，无论你需要什么。工具和技能会根据当前任务通过 RAG 搜索自动选择——无需手动配置。驱动器中的其他一切都旨在让 Agent 随着时间的推移变得更聪明、更快速、更强大。 ### Agent 循环 每一次聊天都是一个 Agent 循环。选择一个工作文件夹，Agent 即可获得文件、搜索和 git 工具。开启沙盒，它将获得在隔离的 Linux VM 中的 shell 访问权限。模型会编写一个 markdown 待办事项列表，据此执行操作，并以经过验证的摘要结束——所有这些都在同一个聊天窗口中完成。请参阅 [Agent 循环指南](docs/AGENT_LOOP.md)。 ### 沙盒 Agent 在由 Apple 的 [Containerization](https://developer.apple.com/documentation/containerization) 框架驱动的隔离 Linux VM 中执行代码。完整的开发环境——shell、Python、Node.js、编译器、包管理器——对你的 Mac 零风险。 每个 Agent 都有自己的 Linux 用户和主目录。VM 通过 vsock 桥接连接回 Osaurus（推理、记忆、密钥）——虽被沙盒化但并未断开连接。使用简单的 JSON 插件配方进行扩展，无需 Xcode 或代码签名。 ``` ┌────────────────┐ ┌────────────────────────────┐ │ Osaurus │ │ Linux VM (Alpine) │ │ │ │ │ │ Sandbox Mgr ──┼───────┤→ /workspace (VirtioFS) │ │ Host API ←──┼─vsock─┤→ osaurus-host bridge │ │ │ │ │ │ │ │ agent-alice (Linux user) │ │ │ │ agent-bob (Linux user) │ └────────────────┘ └────────────────────────────┘ ``` ### 记忆 分为三个层——身份、固定事实和每次会话的情节——外加一份转录回退。Agent 在会话结束时（而非每次交互时）提炼一次对话，根据显著性对重要内容进行评分，并根据你的实际提问，每次请求最多提供一段紧凑的摘要切片。后台整合器负责衰减、合并和清除，使记忆保持敏锐而不臃肿。大多数交互注入约 800 个 token 或更少；许多情况下注入为零。请参阅[记忆指南](docs/MEMORY.md)。 ### 身份 每个参与者——人类、Agent、设备——都会获得一个 secp256k1 加密地址。权限从你的主密钥（iCloud Keychain）向下流动到每个 Agent，形成一条可验证的信任链。创建可移植的访问密钥（`osk-v1`），按 Agent 设定范围，随时撤销。请参阅[身份文档](docs/IDENTITY.md)。 ### 中继 通过 `agent.osaurus.ai` 的安全 WebSocket 隧道将 Agent 暴露给互联网。基于其加密地址为每个 Agent 提供唯一的 URL。无需端口转发，无需 ngrok，无需配置。 ## 模型 驱动器与模型无关。可以自由切换——你的 Agent、记忆和工具都将原样保留。 ### 本地 在 Apple Silicon 上使用优化的 MLX 推理运行 Gemma 4、Qwen3.6、GPT-OSS、Llama 等模型。Osaurus 在 Hugging Face 上维护着自己的[优化模型库](https://huggingface.co/OsaurusAI)，其中包含为 Apple Silicon 上最佳质量体积比而精选的量化版本。模型存储在 `~/MLXModels`（使用 `OSU_MODELS_DIR` 可覆盖此路径）。完全私密，完全离线。 ### Liquid 基础模型 Osaurus 支持 [Liquid AI 的 LFM](https://www.liquid.ai/models) 系列——基于为边缘部署优化的非 Transformer 架构构建的端侧模型。快速解码，低内存占用，开箱即用的强大工具调用能力。 ### Apple 基础模型 在 macOS 26+ 上，将 Apple 的端侧模型用作一等公民的提供者。在 API 请求中传入 `model: "foundation"`。工具调用会自动映射到 Apple 的原生接口。零推理成本，完全隐私。 ### 云端 连接到 OpenAI、Anthropic、Gemini、xAI/Grok、[Venice AI](https://venice.ai)、OpenRouter、Ollama 或 LM Studio。Venice 提供无审查、注重隐私的推理服务，且不保留数据。上下文和记忆在所有提供商之间持久存在。 ## MCP Osaurus 是一个完整的 MCP（模型上下文协议）服务器。赋予 Cursor、Claude Desktop 或任何 MCP 客户端访问你工具的权限： ``` { "mcpServers": { "osaurus": { "command": "osaurus", "args": ["mcp"] } } } ``` 同时它也是一个 MCP 客户端——将远程 MCP 服务器中的工具聚合到 Osaurus 中。详情请参阅 [远程 MCP 提供商指南](docs/REMOTE_MCP_PROVIDERS.md)。 ## 工具和插件 ``` osaurus tools install osaurus.browser # Install from registry osaurus tools list # List installed osaurus tools create MyPlugin --swift # Create a plugin osaurus tools dev com.acme.my-plugin # Dev with hot reload ``` 20 多个原生插件：Mail、Calendar、Vision、macOS Use、XLSX、PPTX、Browser、Music、Git、Filesystem、Search、Fetch 等。插件支持 v1（仅工具）和 v2（完整主机 API）ABI——注册 HTTP 路由、提供 Web 应用支持、在 SQLite 中持久化数据、派发 Agent 任务以及通过任何模型调用推理。请参阅[插件编写指南](docs/PLUGIN_AUTHORING.md)。 ## 更多 **技能与方法**——技能从 GitHub 仓库或文件中导入可重用的 AI 功能，与 [Agent Skills](https://agentskills.io/) 兼容。方法是 Agent 随时间保存并重用的学习型工作流。两者都通过 RAG 搜索自动选择——无需手动配置。请参阅[技能指南](docs/SKILLS.md)。 **自动化**——计划任务在后台运行循环任务。监听器监控文件夹并在文件更改时触发 Agent。 **语音**——通过 Apple Neural Engine 上的 FluidAudio 进行端侧转录。聊天中的语音输入、带有唤醒词激活的 VAD 模式，以及可转录到任何应用的全局热键。没有音频会离开你的 Mac。请参阅[语音输入指南](docs/VOICE_INPUT.md)。 **开发者工具**——服务器资源管理器、MCP 工具检查器、推理监控、插件调试。请参阅[开发者工具指南](docs/DEVELOPER_TOOLS.md)。有关推理调度器、模型租约、连续批处理引擎和调整它们的功能标志，请参阅[推理运行时](docs/INFERENCE_RUNTIME.md)。 ## 兼容的 API 为现有工具提供的即插即用端点： | API | 端点（Endpoint） | | --------- | --------------------------------------------- | | OpenAI | `http://127.0.0.1:1337/v1/chat/completions` | | Anthropic | `http://127.0.0.1:1337/anthropic/v1/messages` | | Ollama | `http://127.0.0.1:1337/api/chat` | 支持所有前缀（`/v1`、`/api`、`/v1/api`）。带有流式工具调用增量的完整函数调用。`/chat/completions` 保持 **严格的 OpenAI 语义**——它返回 `tool_calls` 并由客户端执行，因此 Osaurus 可以无缝地嵌入到已经管理自己工具循环的驱动器（Cursor、OpenWebUI、Continue、Aider）背后。对于服务器端的自主循环，请使用 `POST /agents/{id}/run`；要将 Osaurus 工具暴露给远程 MCP 驱动器，请使用 `/mcp/tools` + `/mcp/call`。有关工具调用、流式处理和 SDK 示例，请参阅 [OpenAI API 指南](docs/OpenAI_API_GUIDE.md)。正在构建连接到 Osaurus 的 macOS 应用？请参阅[共享配置指南](docs/SHARED_CONFIGURATION_GUIDE.md)。 ## CLI ``` osaurus serve --port 1337 # Start on localhost osaurus serve --port 1337 --expose # Expose on LAN osaurus ui # Open the chat UI osaurus status # Check status osaurus stop # Stop the server ``` Homebrew 会自动链接 CLI，或者手动创建符号链接： ``` ln -sf "/Applications/Osaurus.app/Contents/MacOS/osaurus" "$(brew --prefix)/bin/osaurus" ``` ## 架构 ``` ┌─────────────────────────────────────────────────────┐ │ The Harness │ ├──────────┬──────────┬────────────┬──────────────────┤ │ Agents │ Memory │ Agent Loop │ Automation │ ├──────────┴──────────┴────────────┴──────────────────┤ │ MCP Server + Client │ ├──────────┬──────────┬───────────┬───────────────────┤ │ MLX │ OpenAI │ Anthropic │ Ollama / Others │ │ Runtime │ API │ API │ │ ├──────────┴──────────┴───────────┴───────────────────┤ │ Plugin System (v1 / v2 ABI) · Native Plugins │ ├──────────┬──────────┬───────────┬───────────────────┤ │ Identity │ Relay │ Tools │ Skills · Methods │ ├──────────┴──────────┴───────────┴───────────────────┤ │ Sandbox VM (Alpine · Apple Containerization) │ │ vsock bridge · VirtioFS · per-agent isolation │ └─────────────────────────────────────────────────────┘ ``` 大多数功能都可以通过管理窗口（`⌘ ⇧ M`）访问。 ## 从源代码构建 ``` git clone https://github.com/osaurus-ai/osaurus.git cd osaurus open osaurus.xcworkspace ``` 构建并运行 `osaurus` 目标。需要 Xcode 16+ 和 macOS 15.5+。 ### Git 钩子（lefthook） 安装 [lefthook](https://github.com/evilmartians/lefthook) 以设置验证代码质量的钩子： ``` brew install lefthook lefthook install ``` 这将安装一个 `pre-push` 钩子，在每次推送之前对 `Packages/` 目录运行 `swift-format`。 ## 项目结构 ``` osaurus/ ├── App/ # macOS app target (SwiftUI entry point, assets, entitlements) ├── Packages/ │ ├── OsaurusCore/ # Core library — all app logic │ │ ├── Models/ # Data types, DTOs, configuration stores │ │ ├── Services/ # Business logic (actors and stateless types) │ │ ├── Managers/ # UI-facing state holders (@MainActor, observable) │ │ ├── Views/ # SwiftUI views, organized by feature │ │ ├── Networking/ # HTTP server, routing, relay │ │ ├── Storage/ # SQLite databases │ │ ├── Identity/ # Cryptographic identity and access keys │ │ ├── Tools/ # MCP tools, plugin ABI, tool registry │ │ ├── Folder/ # Working-folder context, file ops, batch tool │ │ ├── Utils/ # Cross-cutting utilities │ │ └── Tests/ # Unit and integration tests │ ├── OsaurusCLI/ # CLI (osaurus command) │ └── OsaurusRepository/ # Plugin registry and installation ├── docs/ # Feature guides and documentation ├── scripts/ # Build, release, and benchmark scripts ├── sandbox/ # Sandbox VM Dockerfile └── assets/ # DMG packaging assets ``` 有关架构指南和层定义，请参阅 [CONTRIBUTING.md](docs/CONTRIBUTING.md)。 ## 贡献 Osaurus 正在积极开发中，我们欢迎各种贡献：错误修复、新插件、文档、UI/UX 改进和测试。 欢迎查看 [Good First Issues](https://github.com/osaurus-ai/osaurus/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)，阅读[贡献指南](CONTRIBUTING.md)，或加入 [Discord](https://discord.gg/osaurus)。完整功能清单请参阅 [docs/FEATURES.md](docs/FEATURES.md)。 ## 许可证 [MIT](LICENSE)

Osaurus, Inc. · osaurus.ai

标签：Agent框架, Anthropic API, Apple Foundation Models, Apple Silicon, DLL 劫持, Hugging Face, LLM客户端, LLM评估, macOS客户端, macOS软件, MCP Server, Ollama, OpenAI API, Swift, 个人AI, 人工智能, 加密身份, 原生应用, 大语言模型, 客户端加密, 开源, 持久化记忆, 数字身份, 本地大模型, 本地推理, 本地部署, 模型路由, 用户模式Hook绕过, 离线运行, 网络安全, 自主执行, 隐私保护