---
How to install osaurus?
osaurus-ai/osaurus
$git clone https://github.com/osaurus-ai/osaurusInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install osaurus by running `git clone https://github.com/osaurus-ai/osaurus`, then use it for the current task and follow its documentation at https://github.com/osaurus-ai/osaurus.
README.md
| 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 | |
| 5 | <h1 align="center">Osaurus</h1> |
| 6 | |
| 7 | <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> |
| 11 | |
| 12 | <p align="center"> |
| 13 | <a href="https://trendshift.io/repositories/22454?utm_source=repository-badge&utm_medium=badge&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> |
| 14 | </p> |
| 15 | |
| 16 | <p align="center"> |
| 17 | <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> |
| 18 | <a href="https://github.com/osaurus-ai/osaurus/releases"><img src="https://img.shields.io/github/downloads/osaurus-ai/osaurus/total" alt="Downloads"></a> |
| 19 | <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> |
| 20 | <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> |
| 21 | </p> |
| 22 | |
| 23 | <p align="center"> |
| 24 | <img src="https://img.shields.io/badge/Platform-macOS%20(Apple%20Silicon)-black?logo=apple" alt="Platform"> |
| 25 | <img src="https://img.shields.io/badge/OpenAI%20API-compatible-0A7CFF" alt="OpenAI API"> |
| 26 | <img src="https://img.shields.io/badge/Anthropic%20API-compatible-0A7CFF" alt="Anthropic API"> |
| 27 | <img src="https://img.shields.io/badge/Ollama%20API-compatible-0A7CFF" alt="Ollama API"> |
| 28 | <img src="https://img.shields.io/badge/MCP-server-0A7CFF" alt="MCP Server"> |
| 29 | <img src="https://img.shields.io/badge/Apple%20Foundation%20Models-supported-0A7CFF" alt="Foundation Models"> |
| 30 | <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> |
| 31 | <img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs Welcome"> |
| 32 | </p> |
| 33 | |
| 34 | <p align="center"> |
| 35 | <a href="https://github.com/osaurus-ai/osaurus/releases/latest/download/Osaurus.dmg">Download for Mac</a> · |
| 36 | <a href="https://docs.osaurus.ai">Docs</a> · |
| 37 | <a href="https://huggingface.co/OsaurusAI">Models</a> · |
| 38 | <a href="https://discord.gg/osaurus">Discord</a> · |
| 39 | <a href="https://x.com/OsaurusAI">Twitter</a> · |
| 40 | <a href="https://github.com/osaurus-ai/osaurus-tools">Plugin Registry</a> |
| 41 | </p> |
| 42 | |
| 43 | --- |
| 44 | |
| 45 | ## Inference is all you need. Everything else can be owned by you. |
| 46 | |
| 47 | 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. |
| 48 | |
| 49 | Osaurus 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. |
| 50 | |
| 51 | Works fully offline with local models. Connect to any cloud provider when you want more power. Nothing leaves your Mac unless you choose. |
| 52 | |
| 53 | Native Swift on Apple Silicon. No Electron. No compromises. MIT licensed. |
| 54 | |
| 55 | ## Install |
| 56 | |
| 57 | ```bash |
| 58 | brew install --cask osaurus |
| 59 | ``` |
| 60 | |
| 61 | Or download the latest `.dmg` from [Releases](https://github.com/osaurus-ai/osaurus/releases/latest). After installing, launch from Spotlight (`⌘ Space` → "Osaurus") or the CLI: |
| 62 | |
| 63 | ```bash |
| 64 | osaurus ui # Open the chat UI |
| 65 | osaurus serve # Start the server |
| 66 | osaurus status # Check status |
| 67 | ``` |
| 68 | |
| 69 | > Requires macOS 15.5+ and Apple Silicon. |
| 70 | |
| 71 | ## Agents |
| 72 | |
| 73 | Agents are the core of Osaurus. Each one gets its own prompts, memory, and visual theme -- a research assistant, a coding |
Related
6 picksType
- langchain-mcp-adaptersMake Anthropic Model Context Protocol (MCP) tools compatible with LangChain and LangGraph agents.Jul 2026
- mcporterTypeScript runtime and CLI for connecting to configured Model Context Protocol servers.Jul 2026
- mcp-proxyA MCP server which proxies requests to a remote MCP server over streamable HTTP or SSE.Jul 2026
- mcp-atlassianThe Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification.Jul 2026
- open-webuiOpen WebUIJul 2026
- rulesyncUnified AI rules management CLI tool that generates configuration files for various AI development toolsJul 2026
