Overview | Osaurus Docs

Skip to main content

On this page

Own your AI.

stars…release…downloads…license…

Inference is all you need. Everything else can be owned by you.​

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. Other apps keep that layer on their servers. Osaurus keeps it on your Mac.

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.

Works fully offline with local models. Connect to any cloud provider when you want more power. Nothing leaves your Mac unless you choose. Native Swift on Apple Silicon. No Electron. MIT licensed.

Your data, your Mac<br>Encrypted at rest, signed at every boundary, never sent anywhere unless you explicitly choose a cloud provider. We can't read your conversations and there are no backdoors — see Security & Privacy.

What you get​

A short tour of the things you can do once Osaurus is installed.

A guided first launch. A five-step onboarding walks you through creating your first agent, picking a model (local, Apple Foundation, or cloud), and setting up identity. No config files.

A chat overlay you can open anywhere. Press ⌘; to talk to your AI; press it again to dismiss. No browser tab, no context switch.

Agents that fit different jobs. A coding partner, a research assistant, a file organizer — each with its own prompt, theme, and history.

Memory that learns from you. Past conversations are distilled into compact facts and surfaced only when relevant — no firehose of irrelevant context.

Skills that load themselves. Packaged expertise — research, debugging, writing styles — that surface automatically when the task calls for them.

Working folders. Point a chat at a folder and the agent gets safe file, search, and git tools — scoped to just that directory.

A Linux Sandbox (macOS 26+). Toggle it on and the agent can run real code — shell, Python, Node — in an isolated VM with zero risk to your Mac.

Schedules and Watchers. Run an agent on a timer, or whenever a folder changes. Useful for daily journals, screenshot organizers, end-of-day commits.

Voice input. Dictate in chat, talk to an agent hands-free with a wake word, or hold a hotkey to dictate into any app — all on-device.

Themes. Built-in light/dark, fully editable, importable as JSON.

Identity that's yours. A cryptographic address for you and each of your agents. Issue access keys for outside tools, scope them per-agent, revoke them whenever.

Public links without ports. Give one agent a stable public URL via a secure tunnel through agent.osaurus.ai — no port forwarding, no ngrok.

Get started in 5 minutes →

Build with Osaurus​

Osaurus is also a local server. It speaks OpenAI , Anthropic , Open Responses , and Ollama APIs at the same port — so any SDK you already use just works. And it's a full MCP server and client , so Cursor, Claude Desktop, and other MCP harnesses get instant access to your installed tools.

HTTP API — endpoint reference, streaming, function calling

SDK Examples — Python, JavaScript, Anthropic SDK, Open Responses

CLI — osaurus serve, osaurus tools install/dev/create, osaurus mcp

Tools & Plugins — 20+ native plugins (Mail, Calendar, Vision, Browser, Git, …) and v1/v2 ABI for building your own

Apple Intelligence — using foundation with zero setup on macOS 26+

For the system view of how everything fits together, see Architecture.

System requirements​

macOS 15.5 or later

Apple Silicon (M1, M2, M3, or newer)

macOS 26 features<br>The Sandbox (running agent code in an isolated Linux VM) and Apple Foundation Models require macOS 26 (Tahoe) or later.

Get started​

Installation takes less than a minute.

Install Osaurus

Or jump straight to the Quick Start →

Community​

Osaurus is an indie project, built in public. Join us:

Discord — chat, feedback, show-and-tell

GitHub — issues, contributions, roadmap

Hugging Face — curated quantizations for Apple Silicon

Plugin Registry — browse and submit tools

Blog — long-form thinking on personal AI

Inference is all you need. Everything else can be owned by you.What you getBuild with OsaurusSystem requirementsGet startedCommunity