Skip to main content

Quick Start

Five minutes from a fresh Mac to a working AI you own. Here's the whole flow.

1. Install​

Grab the DMG from osaurus.ai, drag it into your Applications folder, and launch it from Spotlight (⌘ Space → "Osaurus"). That's it.

The app is signed and notarized, so it opens without security warnings. Full guide: Installation.

2. Walk through onboarding​

A short, three-screen wizard greets you on first launch:

  1. Welcome — click Get Started.
  2. Create Dino — name your first agent. You can rename and customize it later, and create specialist agents whenever you need them. Agents →
  3. Configure AI — choose how the agent will run.

Give your dino a brain​

Osaurus recommends the best local model your Mac can run — the pick is based on your machine's memory, so a mainstream Mac and a maxed-out one get different (equally sensible) defaults. A Change control lets you pick another local model if you'd rather.

You don't have to wait for the download: Osaurus Cloud is included with a free welcome credit, so you can skip the download and start chatting on hosted models immediately — or use Cloud while the local model downloads in the background.

Choosing Set up later also selects Osaurus Cloud rather than leaving the app without a working model. Apple Foundation Models remain available after onboarding, but are not offered in this first-run step because the onboarding path prioritizes models that support tools and agent work.

Prefer your own provider? Use an API key drills into OpenAI, Anthropic, and friends, plus a local Ollama server or any custom OpenAI-compatible endpoint. You can always add more later from Management → Local Models or Management → Cloud Models.

The old plugin picker, walkthrough carousel, consent screen, and in-onboarding code redemption are no longer part of onboarding. After setup, manage native plugins in Management → Tools → Native Plugins, privacy choices in Settings → Privacy, and credits in Management → Credits.

Identity and Sandbox are automatic

There's no identity or sandbox step anymore. Your identity key is created silently on completion — it lives in your iCloud Keychain, gated by Face ID / Touch ID. When you have a minute, save your 24-word recovery phrase from Management → Identity → View recovery phrase; it's what restores your identity on a new Mac. The Sandbox is configured with defaults and provisions itself lazily the first time an agent actually needs it — no surprise multi-GB download. Identity → · Sandbox →

3. Pick your Core Model​

This is the one knob most people miss on day one. Open Settings (⌘ ,) → General → Core Model and pick a model.

Why it matters​

The Core Model is a small, lightweight model Osaurus uses for background work:

  • Remembering things — distills your conversations into compact facts the AI can recall later. Without a Core Model set, this never runs and memory pauses.
  • Picking the right tools — surfaces the relevant tools and skills for each message. Falls back to your chat model when Core Model is unset.

What to pick​

If foundation is available, that's the right answer 99% of the time — it's free, fast, and never leaves your Mac. Otherwise:

You havePick
macOS 26+foundation (Apple's on-device model)
macOS 15.5+ with a local modelThe smallest fast model you've downloaded (e.g. gemma-4-e2b-it-4bit)
Cloud-only setupAny cheap, fast remote model (e.g. anthropic/claude-haiku-4-5)
tip

Choosing Use chat model (default) in this picker leaves Core Model unset. That's fine for ad-hoc usage, but memory won't update. Pick an explicit model if you want memory and auto-selected tools working in the background.

4. Try your first chat​

Press ⌘; from anywhere on your Mac. The chat overlay appears.

Type something:

Hi! Tell me a fun fact about dinosaurs.

Press Enter. You'll see the response stream in real-time. Press ⌘; again to dismiss.

Have it actually do something​

Try giving the agent a real task — it'll write a plan, use tools, and bring back the result:

  1. Press ⌘; to open chat
  2. Click the folder icon next to the input bar and pick a folder you don't mind it touching
  3. Ask: "Summarize what's in this folder and add a README.md describing it."

You'll see a live to-do list appear and tick off as the agent reads files, drafts the README, and writes it. The new file shows up as an artifact card right in the chat.

New custom agents start with Sandbox execution enabled where supported — a Linux VM on macOS 26+, a Seatbelt-confined runner on macOS 15. Selecting a trusted folder disables Sandbox for that agent so it can work directly in the folder; re-enable it later from Agents → Abilities for isolated scripts, downloads, and builds. Tasks →

Try voice​

Click the microphone in the input bar and speak. Transcription happens entirely on-device via Apple's Neural Engine — your voice never leaves your Mac. Or set up the global Transcription Mode hotkey to dictate into any app on your Mac. Voice →

What's next​

Now that you're set up:

For everyday use:

  • Chat — overlay, multi-window, sessions, shortcuts
  • Agents — create specialized assistants for different tasks
  • Memory — what your AI remembers and how
  • Skills — reusable expertise, automatically loaded
  • Voice — dictate, wake-words, global transcription
  • Themes — make the chat overlay yours

For developers:

Care about privacy? The whole story is on the Privacy & Trust page.

Need help? Join the Discord or open a GitHub issue.