Skip to content
Back to search

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/osaurus-ai/osaurus with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/osaurus-ai/osaurus'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/osaurus-ai--osaurus/badge.svg)](/listings/osaurus-ai--osaurus)

HTML

<a href="/listings/osaurus-ai--osaurus"><img src="/api/listings/osaurus-ai--osaurus/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

brew install --cask osaurus

Or download the latest `.dmg` from [Releases](https://github.com/osaurus-ai/osaurus/releases/latest). Two builds ship per release:

- **`Osaurus-<version>.dmg`** (~70 MB) — the standard build. Pick and download a model during onboarding. This is what Homebrew and in-app updates use. - **`Osaurus-<version>-full.dmg`** (~4 GB, linked from each release's notes and hosted on [Hugging Face](https://huggingface.co/datasets/OsaurusAI/osaurus-releases)) — the same app with [Raptor 0.6](https://huggingface.co/OsaurusAI/Raptor-0.6-4B-JANG_6M) bundled. First launch installs the model into `~/MLXModels` and onboarding skips the download, so you can chat offline immediately. Updates afterwards are the small build.

After installing, launch from Spotlight (`⌘ Space` → "Osaurus") or the CLI:

osaurus ui       # Open the chat UI
osaurus serve    # Start the server
osaurus status   # Check status

> Requires macOS 15.5+ and Apple Silicon.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 199 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img width="1920" height="1080" alt="osaurus-techcrunch-1" src="https://github.com/user-attachments/assets/d7905005-71fe-41ba-b69f-e8968af29b5c" />
  3. </p>
  4. <h1 align="center">Osaurus</h1>
  5. <p align="center">
  6. <strong>Own your AI.</strong><br>
  7. Agents, memory, tools, and identity that live on your Mac. Built purely in Swift. Fully offline. Open source.
  8. </p>
  9. <p align="center">
  10. <a href="https://trendshift.io/repositories/22454?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-22454" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/22454" alt="osaurus-ai%2Fosaurus | Trendshift" width="250" height="55"/></a>
  11. </p>
  12. <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>
  18. <p align="center">
  19. <img src="https://img.shields.io/badge/Platform-macOS%20(Apple%20Silicon)-black?logo=apple" alt="Platform">
  20. <img src="https://img.shields.io/badge/OpenAI%20API-compatible-0A7CFF" alt="OpenAI API">
  21. <img src="https://img.shields.io/badge/Open%20Responses-compatible-0A7CFF" alt="Open Responses">
  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. <a href="https://huggingface.co/OsaurusAI"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-OsaurusAI-FFD21E" alt="Hugging Face"></a>
  27. <img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs Welcome">
  28. </p>
  29. <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://huggingface.co/datasets/OsaurusAI/osaurus-releases/resolve/main/Osaurus-full.dmg">Download with Raptor 0.7 bundled (~4 GB)</a> ·
  32. <a href="https://docs.osaurus.ai">Docs</a> ·
  33. <a href="https://huggingface.co/OsaurusAI">Models</a> ·
  34. <a href="https://discord.gg/osaurus">Discord</a> ·
  35. <a href="https://x.com/OsaurusAI">Twitter</a> ·
  36. <a href="https://github.com/osaurus-ai/osaurus-tools">Plugin Registry</a>
  37. </p>
  38. ---
  39. ## Why Osaurus
  40. Models are getting cheaper, better, and more interchangeable every month. The model you use today will not be the one you use next year.
  41. What doesn't get replaced is everything around the model: what your assistant knows about you, the tools it can use, the work it has learned to do, and the identity it acts under. That layer is what makes AI useful to you personally, and it compounds over time. Most AI products keep it on their servers, tied to their model.
  42. Osaurus keeps it on your Mac. Your agents, memory, tools, and keys live locally, work fully offline with local models, and stay intact when you switch to a different local or cloud model. Nothing leaves your Mac unless you choose a cloud model or turn on a feature that connects out. Native Swift on Apple Silicon, no Electron, MIT licensed.
  43. ## What it does
  44. You talk to one assistant, the **Orchestrator**. Ask in your own words and it decides how to handle the request:
  45. - **Answers** questions directly, from what it knows or what's already in the chat.
  46. - **Changes Osaurus for you**, like "switch my default model" or "add a provider", showing an approval card first. Nothing changes until you confirm.
  47. - **Hands work to your team.** A fresh install comes with a small team of agents, each bound to one app or folder: **Planner** (Calendar and Reminders), **Courier** (Mail), **Keeper** (Downloads and Notes), **Scout** (the web), and, on a Mac set up for development, **Builder** (a project folder). You can rename them or create your own.
  48. - **Uses built-in helpers** for hands-on work: **Research** (web search with sources), **Files** (your chat's working folder), **Browser** (sites you're signed in to), and **Code** (an isolated sandbox).
  49. - **Runs workflows.** It starts one of your saved workflows when a request matches, or sketches a small one on the spot and offers to keep it if it worked.
  50. When you first launch Osaurus, you choose how it runs: a private model on this Mac, Osaurus Cloud (nothing to download), or an AI account you already have. You can change that at any time, and your agents and memory carry over.
  51. ## What you get
  52. - **Agents**: custom agents, each with its own prompt, model, tools, memory, working folder, and avatar. They can run on Osaurus's own [agent loop](docs/AGENT_LOOP.md) or on an external harness such as Claude Code ([Agent Runtimes](docs/HARNESS_RUNTIMES.md)). See the [Agents guide](Packages/OsaurusCore/Resources/Guide/guide-agents.md) and the [Orchestrator guide](docs/ORCHESTRATOR.md).
  53. - **Workflows and the Architect**: typed, repeatable multi-step workflows. The built-in Architect agent designs, tests, and fixes them for you. See [Workflows](docs/WORKFLOWS.md).
  54. - **Automations**: run a workflow, an agent, or a model on a schedule, a folder change, a webhook, or a feed. See [Automations](docs/AUTOMATIONS.md).
  55. - **Memory and knowledge**: layered memory that stays small and relevant, plus document libraries agents can search. See [Memory](docs/MEMORY.md) and [Knowledge](docs/KNOWLEDGE.md).
  56. - **Sandbox**: agents run code in an isolated Linux VM, with a per-agent user and home folder, on macOS 26+. See [Sandbox](docs/SANDBOX.md).
  57. - **Browser and computer use**: a per-agent browser session, plus macOS control with per-app autonomy rules. Both are off by default. See [Browser Use](docs/BROWSER.md) and [Computer Use](docs/COMPUTER_USE.md).
  58. - **Apple apps**: Calendar, Reminders, Contacts, Notes, Mail, Messages, Maps, Music, and Shortcuts as native tools, turned on per agent. See [Apple Apps](docs/APPLE_APPS.md).
  59. - **Channels**: agents read and post on Discord, Slack, Telegram, iMessage, WhatsApp, Email, and n8n, with strict allowlists. See [Agent Channels](docs/AGENT_CHANNELS.md).
  60. - **Privacy filter**: before a cloud send, an on-device classifier finds names, emails, keys, and other secrets and swaps them for placeholders. It fails closed if anything leaks. See [Privacy Filter](docs/PRIVACY_FILTER.md).
  61. - **Identity and secure channels**: every agent has a cryptographic address, can be reached through a relay, and talks to other Osaurus agents end-to-end encrypted. See [Identity](docs/IDENTITY.md) and [Secure Channel](docs/SECURE_CHANNEL.md).
  62. - **Devices and Workspaces**: sync chats end-to-end encrypted between your Macs and iPhone, and share agents and workflows with teammates. See [Sync](docs/SYNC.md) and [Workspaces](docs/OSAURUS_WORKSPACES.md).
  63. - **Voice**: on-device transcription, wake word, and a system-wide dictation hotkey. See [Voice Input](docs/VOICE_INPUT.md).
  64. - **Images**: generate and edit images on-device with local image models. See the [Images guide](Packages/OsaurusCore/Resources/Guide/guide-images.md).
  65. - **Skills and plugins**: import [Agent Skills](https://agentskills.io/) and Claude plugins, or install native plugins from the registry. See [Skills](docs/SKILLS.md), [Claude Plugins](docs/CLAUDE_PLUGINS.md), and [Plugin Authoring](docs/plugins/README.md).
  66. - **MCP, both ways**: Osaurus is an MCP server for other clients, and an MCP client that connects to remote MCP services with one-tap OAuth. See [Remote MCP Providers](docs/REMOTE_MCP_PROVIDERS.md).
  67. - **Shortcuts, Spotlight, and Siri**: "Ask Osaurus" and "Run Osaurus Agent" work system-wide. See [App Intents](docs/APP_INTENTS.md).
  68. For the full inventory, see [docs/FEATURES.md](docs/FEATURES.md).
  69. ## Models
  70. Osaurus doesn't depend on any one model. Swap models freely and your agents, memory, and tools stay intact.
  71. - **Local**: Gemma, Qwen, GPT-OSS, Llama, LFM, and more, running on Apple Silicon through MLX. Osaurus publishes [curated quantizations on Hugging Face](https://huggingface.co/OsaurusAI) tuned for quality per gigabyte. Models live in `~/MLXModels` (override with `OSU_MODELS_DIR`), and models already in your Hugging Face cache or LM Studio can be used in place.
  72. - **Apple Foundation Models**: on macOS 26+ with Apple Intelligence, Apple's on-device model is available as `foundation`.
  73. - **Cloud**: OpenAI, Anthropic, Gemini, xAI, Venice AI, OpenRouter, Ollama, LM Studio, or any endpoint that speaks the OpenAI, Anthropic, or Open Responses format. See [Remote Providers](docs/REMOTE_PROVIDERS.md).
  74. - **Osaurus Cloud**: pay-as-you-go access through [Osaurus Router](docs/OSAURUS_ROUTER.md), with no separate provider account. Osaurus doesn't store your prompt or response content, only the usage metadata needed for billing.
  75. ## Install
  76. ```bash
  77. brew install --cask osaurus
  78. ```
  79. Or download a `.dmg` from [Releases](https://github.com/osaurus-ai/osaurus/releases/latest). Each release ships two builds:
  80. - **`Osaurus-<version>.dmg`** (~70 MB) is the standard build. You pick a model during setup. Homebrew and in-app updates use this build.
  81. - **`Osaurus-<version>-full.dmg`** (~4 GB, on [Hugging Face](https://huggingface.co/datasets/OsaurusAI/osaurus-releases)) is the same app with [Raptor 0.7](https://huggingface.co/OsaurusAI/Raptor-0.7-4B-JANG_6M) bundled, so you can chat offline right after install. Later updates use the small build. The newest stable one is always at [`Osaurus-full.dmg`](https://huggingface.co/datasets/OsaurusAI/osaurus-releases/resolve/main/Osaurus-full.dmg).
  82. > Requires macOS 15.5+ and Apple Silicon. The sandbox VM and Apple Foundation Models need macOS 26+.
  83. Open the chat window with the global hotkey (default `⌘;`) or from Spotlight. Settings… (`⌘,`) holds everything else. Homebrew installs the CLI; otherwise use Settings → Server → Overview → Command Line Tool → **Install CLI**:
  84. ```bash
  85. osaurus ui # Open the chat UI
  86. osaurus serve # Start the server (add --expose for LAN access)
  87. osaurus status # Check status
  88. osaurus stop # Stop the server
  89. ```
  90. ## For developers
  91. Osaurus runs a local server with drop-in endpoints for existing tools:
  92. | API | Endpoint |
  93. | --------- | --------------------------------------------- |
  94. | OpenAI | `http://127.0.0.1:1337/v1/chat/completions` |
  95. | Responses | `http://127.0.0.1:1337/v1/responses` |
  96. | Anthropic | `http://127.0.0.1:1337/v1/messages` |
  97. | Ollama | `http://127.0.0.1:1337/api/chat` |
  98. `/chat/completions` keeps strict OpenAI semantics: it returns `tool_calls` and your client runs them. `/v1/responses` speaks the item-based [Open Responses](https://www.openresponses.org) format, so Responses-only clients such as Codex work too. For server-side autonomous runs, use `POST /agents/{id}/run`. See the [OpenAI API Guide](docs/OpenAI_API_GUIDE.md).
  99. To give any MCP client access to your Osaurus tools:
  100. ```json
  101. {
  102. "mcpServers": {
  103. "osaurus": { "command": "osaurus", "args": ["mcp"] }
  104. }
  105. }
  106. ```
  107. If network exposure is on, add `"env": { "OSAURUS_MCP_ACCESS_KEY": "osk-v1..." }`.
  108. More for developers:
  109. - [Shared Configuration](docs/SHARED_CONFIGURATION_GUIDE.md): connecting your own macOS app to Osaurus.
  110. - [Osaurus Bundles](docs/OSAURUS_BUNDLES.md): shipping Osaurus with your agents, skills, and MCP servers pre-installed (`osaurus import`).
  111. - [Developer Tools](docs/DEVELOPER_TOOLS.md): Server and API Reference, and Insights.
  112. - [Inference Runtime](docs/INFERENCE_RUNTIME.md): the scheduler, batching, and caches.
  113. ## Privacy and telemetry
  114. Your chats, memory, agents, and configuration are stored under `~/.osaurus/` on your Mac. Storage is plaintext by default (protected by FileVault), with opt-in SQLCipher encryption; see [Storage](docs/STORAGE.md).
  115. Osaurus collects **anonymous, aggregated usage analytics** through [Aptabase](https://aptabase.com) to understand how the app is used and where people get stuck. It never includes your chats, prompts, files, model outputs, or keys, and events aren't tied to an account or device profile. Analytics are on by default; turn them off during setup or in Settings → Privacy & Security → **Share Anonymous Usage Data**. Every event and property is listed in [Telemetry](docs/TELEMETRY.md).
  116. ### Crash reporting
  117. Crash and app-hang reports go to [Sentry](https://sentry.io). This switch is separate from analytics, on by default, and can be turned off in Settings → Privacy & Security → **Send Crash Reports**. Reports carry crash and hang diagnostics only: no performance tracing, network breadcrumbs, screenshots, user object, or device hostname.
  118. Source builds have both off: with no keys configured, neither SDK starts. To enable them locally, see [Telemetry in local builds](docs/CONTRIBUTING.md#telemetry-in-local-builds).
  119. ## Build from source
  120. ```bash
  121. git lfs install
  122. git clone https://github.com/osaurus-ai/osaurus.git
  123. cd osaurus
  124. open osaurus.xcworkspace
  125. ```
  126. Build and run the `osaurus` scheme. Requires Xcode 26+ and [Git LFS](https://git-lfs.com). See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for the project layout, architecture guide, tests, and git hooks.
  127. ## Contributing
  128. We welcome bug fixes, plugins, documentation, UI/UX improvements, and testing. Start with [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](docs/CONTRIBUTING.md), or join us on [Discord](https://discord.gg/osaurus).
  129. > [!NOTE]
  130. > **Help translate Osaurus.** Native speakers of **German, Chinese, Korean, and Russian**: about a quarter of the app is still in English, and thousands of machine-assisted strings need a review. We're also looking for people to start **Spanish** and **Japanese**. No Swift needed, and small PRs are welcome. See [docs/TRANSLATORS.md](docs/TRANSLATORS.md).
  131. ## Community
  132. - [Discord](https://discord.gg/osaurus): chat, feedback, show-and-tell
  133. - [Twitter](https://x.com/OsaurusAI): updates and demos
  134. - [Hugging Face](https://huggingface.co/OsaurusAI): optimized models for Apple Silicon
  135. - [Community Calls](https://lu.ma/osaurus): every two weeks, open to everyone
  136. - [Blog](https://osaurus.ai/blog): long-form thinking on personal AI
  137. - [Docs](https://docs.osaurus.ai): guides and tutorials
  138. - [Plugin Registry](https://github.com/osaurus-ai/osaurus-tools): browse and contribute tools
  139. ## License
  140. [MIT](LICENSE)
  141. ---
  142. <p align="center">
  143. Osaurus, Inc. · <a href="https://osaurus.ai">osaurus.ai</a>
  144. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.