Own your AI. Agents, memory, tools, and identity that live on your Mac. Built purely in Swift. Fully offline. Open source. Download for Mac · Plugin Registry Models are getting cheaper and more interchangeable by the day. What's irreplaceable is the layer around them -- your context, your memory, your tools, your identity. Others keep that layer on their servers. Osaurus keeps it on your machine.
Add this skill
npx mdskills install osaurus-ai/osaurusComprehensive AI harness platform with agents, memory, sandboxing, and extensive tooling ecosystem
1<p align="center">2<img width="865" height="677" alt="Screenshot 2026-03-19 at 3 42 04 PM" src="https://github.com/user-attachments/assets/c16ee8bb-7f31-4659-9c2c-6eaaf8441c26" />3</p>45<h1 align="center">Osaurus</h1>67<p align="center">8 <strong>Own your AI.</strong><br>9 Agents, memory, tools, and identity that live on your Mac. Built purely in Swift. Fully offline. Open source.10</p>1112<p align="center">13 <a href="https://github.com/osaurus-ai/osaurus/releases/latest"><img src="https://img.shields.io/github/v/release/osaurus-ai/osaurus?sort=semver" alt="Release"></a>14 <a href="https://github.com/osaurus-ai/osaurus/releases"><img src="https://img.shields.io/github/downloads/osaurus-ai/osaurus/total" alt="Downloads"></a>15 <a href="https://github.com/osaurus-ai/osaurus/blob/main/LICENSE"><img src="https://img.shields.io/github/license/osaurus-ai/osaurus" alt="License"></a>16 <a href="https://github.com/osaurus-ai/osaurus/stargazers"><img src="https://img.shields.io/github/stars/osaurus-ai/osaurus?style=social" alt="Stars"></a>17</p>1819<p align="center">20 <img src="https://img.shields.io/badge/Platform-macOS%20(Apple%20Silicon)-black?logo=apple" alt="Platform">21 <img src="https://img.shields.io/badge/OpenAI%20API-compatible-0A7CFF" alt="OpenAI API">22 <img src="https://img.shields.io/badge/Anthropic%20API-compatible-0A7CFF" alt="Anthropic API">23 <img src="https://img.shields.io/badge/Ollama%20API-compatible-0A7CFF" alt="Ollama API">24 <img src="https://img.shields.io/badge/MCP-server-0A7CFF" alt="MCP Server">25 <img src="https://img.shields.io/badge/Apple%20Foundation%20Models-supported-0A7CFF" alt="Foundation Models">26 <img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs Welcome">27</p>2829<p align="center">30 <a href="https://github.com/osaurus-ai/osaurus/releases/latest/download/Osaurus.dmg">Download for Mac</a> ·31 <a href="https://docs.osaurus.ai">Docs</a> ·32 <a href="https://discord.com/invite/dinoki">Discord</a> ·33 <a href="https://x.com/OsaurusAI">Twitter</a> ·34 <a href="https://github.com/osaurus-ai/osaurus-tools">Plugin Registry</a>35</p>3637---3839## Inference is all you need. Everything else can be owned by you.4041Models are getting cheaper and more interchangeable by the day. What's irreplaceable is the layer around them -- your context, your memory, your tools, your identity. Others keep that layer on their servers. Osaurus keeps it on your machine.4243Osaurus is the AI harness for macOS. It sits between you and any model -- local or cloud -- and provides the continuity that makes AI personal: agents that remember, execute autonomously, run real code, and stay reachable from anywhere. The models are interchangeable. The harness is what compounds.4445Works fully offline with local models. Connect to any cloud provider when you want more power. Nothing leaves your Mac unless you choose.4647Native Swift on Apple Silicon. No Electron. No compromises. MIT licensed.4849## Install5051```bash52brew install --cask osaurus53```5455Or download the latest `.dmg` from [Releases](https://github.com/osaurus-ai/osaurus/releases/latest). After installing, launch from Spotlight (`⌘ Space` → "Osaurus") or the CLI:5657```bash58osaurus ui # Open the chat UI59osaurus serve # Start the server60osaurus status # Check status61```6263> Requires macOS 15.5+ and Apple Silicon.6465## Agents6667Agents are the core of Osaurus. Each one gets its own prompts, memory, and visual theme -- a research assistant, a coding partner, a file organizer, whatever you need. Tools and skills are automatically selected via RAG search based on the task at hand -- no manual configuration needed. Everything else in the harness exists to make agents smarter, faster, and more capable over time.6869### Work Mode7071Give an agent an objective. It breaks the work into trackable issues, executes step by step -- parallel tasks, file operations, background processing. Describe what you want done, not how to do it.7273### Sandbox7475Agents execute code in an isolated Linux VM powered by Apple's [Containerization](https://developer.apple.com/documentation/containerization) framework. Full dev environment -- shell, Python, Node.js, compilers, package managers -- with zero risk to your Mac.7677Each agent gets its own Linux user and home directory. The VM connects back to Osaurus (inference, memory, secrets) via a vsock bridge -- sandboxed but not disconnected. Extend with simple JSON plugin recipes, no Xcode or code signing required.7879```80┌────────────────┐ ┌────────────────────────────┐81│ Osaurus │ │ Linux VM (Alpine) │82│ │ │ │83│ Sandbox Mgr ──┼───────┤→ /workspace (VirtioFS) │84│ Host API ←──┼─vsock─┤→ osaurus-host bridge │85│ │ │ │86│ │ │ agent-alice (Linux user) │87│ │ │ agent-bob (Linux user) │88└────────────────┘ └────────────────────────────┘89```9091> Requires macOS 26+ (Tahoe). See the [Sandbox Guide](docs/SANDBOX.md) for configuration, built-in tools, and plugin authoring.9293### Memory94954-layer system: user profile, working memory, conversation summaries, and a knowledge graph. Extracts facts, detects contradictions, recalls relevant context -- all automatically. Agents get smarter over time, and that knowledge stays with you, not a provider.9697### Identity9899Every participant -- human, agent, device -- gets a secp256k1 cryptographic address. Authority flows from your master key (iCloud Keychain) down to each agent in a verifiable chain of trust. Create portable access keys (`osk-v1`), scope per-agent, revoke anytime. See [Identity docs](docs/IDENTITY.md).100101### Relay102103Expose agents to the internet via secure WebSocket tunnels through `agent.osaurus.ai`. Unique URL per agent based on its crypto address. No port forwarding, no ngrok, no configuration.104105## Models106107The harness is model-agnostic. Swap freely -- your agents, memory, and tools stay intact.108109### Local110111Run Llama, Qwen, Gemma, Mistral, DeepSeek, and more on Apple Silicon with optimized MLX inference. Models stored at `~/MLXModels` (override with `OSU_MODELS_DIR`). Fully private, fully offline.112113### Liquid Foundation Models114115Osaurus supports [Liquid AI's LFM](https://www.liquid.ai/models) family -- on-device models built on a non-transformer architecture optimized for edge deployment. Fast decode, low memory footprint, and strong tool calling out of the box.116117### Apple Foundation Models118119On macOS 26+, use Apple's on-device model as a first-class provider. Pass `model: "foundation"` in API requests. Tool calling maps through Apple's native interface automatically. Zero inference cost, fully private.120121### Cloud122123Connect to OpenAI, Anthropic, Gemini, xAI/Grok, [Venice AI](https://venice.ai), OpenRouter, Ollama, or LM Studio. Venice provides uncensored, privacy-focused inference with no data retention. Context and memory persist across all providers.124125## MCP126127Osaurus is a full MCP (Model Context Protocol) server. Give Cursor, Claude Desktop, or any MCP client access to your tools:128129```json130{131 "mcpServers": {132 "osaurus": {133 "command": "osaurus",134 "args": ["mcp"]135 }136 }137}138```139140Also an MCP client -- aggregate tools from remote MCP servers into Osaurus. See the [Remote MCP Providers Guide](docs/REMOTE_MCP_PROVIDERS.md) for details.141142## Tools & Plugins143144```bash145osaurus tools install osaurus.browser # Install from registry146osaurus tools list # List installed147osaurus tools create MyPlugin --swift # Create a plugin148osaurus tools dev com.acme.my-plugin # Dev with hot reload149```15015120+ native plugins: Mail, Calendar, Vision, macOS Use, XLSX, PPTX, Browser, Music, Git, Filesystem, Search, Fetch, and more. Plugins support v1 (tools only) and v2 (full host API) ABIs -- register HTTP routes, serve web apps, persist data in SQLite, dispatch agent tasks, and call inference through any model. See the [Plugin Authoring Guide](docs/PLUGIN_AUTHORING.md).152153## More154155**Skills & Methods** -- Skills import reusable AI capabilities from GitHub repos or files, compatible with [Agent Skills](https://agentskills.io/). Methods are learned workflows that agents save and reuse over time. Both are automatically selected via RAG search -- no manual configuration needed. See [Skills Guide](docs/SKILLS.md).156157**Automation** -- Schedules run recurring tasks in the background. Watchers monitor folders and trigger agents on file changes.158159**Voice** -- On-device transcription via FluidAudio on Apple's Neural Engine. Voice input in chat, VAD mode with wake-word activation, and a global hotkey to transcribe into any app. No audio leaves your Mac. See [Voice Input Guide](docs/VOICE_INPUT.md).160161**Developer Tools** -- Server explorer, MCP tool inspector, inference monitoring, plugin debugging. See [Developer Tools Guide](docs/DEVELOPER_TOOLS.md).162163## Compatible APIs164165Drop-in endpoints for existing tools:166167| API | Endpoint |168| --------- | --------------------------------------------- |169| OpenAI | `http://127.0.0.1:1337/v1/chat/completions` |170| Anthropic | `http://127.0.0.1:1337/anthropic/v1/messages` |171| Ollama | `http://127.0.0.1:1337/api/chat` |172173All prefixes supported (`/v1`, `/api`, `/v1/api`). Full function calling with streaming tool call deltas. See [OpenAI API Guide](docs/OpenAI_API_GUIDE.md) for tool calling, streaming, and SDK examples. Building a macOS app that connects to Osaurus? See the [Shared Configuration Guide](docs/SHARED_CONFIGURATION_GUIDE.md).174175## CLI176177```bash178osaurus serve --port 1337 # Start on localhost179osaurus serve --port 1337 --expose # Expose on LAN180osaurus ui # Open the chat UI181osaurus status # Check status182osaurus stop # Stop the server183```184185Homebrew auto-links the CLI, or symlink manually:186187```bash188ln -sf "/Applications/Osaurus.app/Contents/MacOS/osaurus" "$(brew --prefix)/bin/osaurus"189```190191## Architecture192193```194┌─────────────────────────────────────────────────────┐195│ The Harness │196├──────────┬──────────┬───────────┬───────────────────┤197│ Agents │ Memory │ Work Mode │ Automation │198├──────────┴──────────┴───────────┴───────────────────┤199│ MCP Server + Client │200├──────────┬──────────┬───────────┬───────────────────┤201│ MLX │ OpenAI │ Anthropic │ Ollama / Others │202│ Runtime │ API │ API │ │203├──────────┴──────────┴───────────┴───────────────────┤204│ Plugin System (v1 / v2 ABI) · Native Plugins │205├──────────┬──────────┬───────────┬───────────────────┤206│ Identity │ Relay │ Tools │ Skills · Methods │207├──────────┴──────────┴───────────┴───────────────────┤208│ Sandbox VM (Alpine · Apple Containerization) │209│ vsock bridge · VirtioFS · per-agent isolation │210└─────────────────────────────────────────────────────┘211```212213Most features are accessible through the Management window (`⌘ ⇧ M`).214215## Build from Source216217```bash218git clone https://github.com/osaurus-ai/osaurus.git219cd osaurus220open osaurus.xcworkspace221```222223Build and run the `osaurus` target. Requires Xcode 16+ and macOS 15.5+.224225### Git Hooks (lefthook)226227Install [lefthook](https://github.com/evilmartians/lefthook) to set up the hooks that verify quality of the code:228229```bash230brew install lefthook231lefthook install232```233234This installs a `pre-push` hook that runs `swift-format` over the `Packages/` directory before each push.235236## Project Structure237238```239osaurus/240├── App/ # macOS app target (SwiftUI entry point, assets, entitlements)241├── Packages/242│ ├── OsaurusCore/ # Core library — all app logic243│ │ ├── Models/ # Data types, DTOs, configuration stores244│ │ ├── Services/ # Business logic (actors and stateless types)245│ │ ├── Managers/ # UI-facing state holders (@MainActor, observable)246│ │ ├── Views/ # SwiftUI views, organized by feature247│ │ ├── Networking/ # HTTP server, routing, relay248│ │ ├── Storage/ # SQLite databases249│ │ ├── Identity/ # Cryptographic identity and access keys250│ │ ├── Tools/ # MCP tools, plugin ABI, tool registry251│ │ ├── Work/ # Work mode execution context and file ops252│ │ ├── Utils/ # Cross-cutting utilities253│ │ └── Tests/ # Unit and integration tests254│ ├── OsaurusCLI/ # CLI (osaurus command)255│ └── OsaurusRepository/ # Plugin registry and installation256├── docs/ # Feature guides and documentation257├── scripts/ # Build, release, and benchmark scripts258├── sandbox/ # Sandbox VM Dockerfile259└── assets/ # DMG packaging assets260```261262See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for the architecture guide and layer definitions.263264## Contributing265266Osaurus is actively developed and we welcome contributions: bug fixes, new plugins, documentation, UI/UX improvements, and testing.267268Check out [Good First Issues](https://github.com/osaurus-ai/osaurus/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22), read the [Contributing Guide](CONTRIBUTING.md), or join [Discord](https://discord.com/invite/dinoki). See [docs/FEATURES.md](docs/FEATURES.md) for the full feature inventory.269270## Community271272- [Discord](https://discord.com/invite/dinoki) -- chat, feedback, show-and-tell273- [Twitter](https://x.com/OsaurusAI) -- updates and demos274- [Community Calls](https://lu.ma/osaurus) -- bi-weekly, open to everyone275- [Blog](https://osaurus.ai/blog) -- long-form thinking on personal AI276- [Docs](https://docs.osaurus.ai) -- guides and tutorials277- [Plugin Registry](https://github.com/osaurus-ai/osaurus-tools) -- browse and contribute tools278279## License280281[MIT](LICENSE)282283---284285<p align="center">286 Osaurus, Inc. · <a href="https://osaurus.ai">osaurus.ai</a>287</p>288
Full transparency — inspect the skill content before installing.