Onboarding Guide
When you first launch SafeRag, you'll be guided through a setup process. This guide explains each step of the onboarding experience.
Onboarding Overview
Setup takes three steps:
- Welcome - A single welcome screen
- Quick Setup - Choose a username (optional)
- AI Model - Download your first AI model
Welcome
The first screen introduces SafeRag: private AI that runs entirely on your Mac. Click Get Started to continue. While you read it, SafeRag starts its built-in AI runtime in the background.
Quick Setup
Next you set up your account. This is quick and simple:
- Enter a username (optional) — leave it blank to use your Mac username
- No password to choose — SafeRag handles security automatically
- Click Continue to proceed
Behind the scenes:
- Automatic Security — A secure password is generated and stored safely in your Keychain
- Instant Access — SafeRag signs you in automatically and opens directly to your workspace
Download an AI Model
You need at least one AI model to use SafeRag. The last step lists four models and marks one as Recommended for your Mac's memory. Each also shows a speed rating for your Mac (Fast, OK or Slow).
| Model | Size | Best For |
|---|---|---|
| Qwen3.5 4B | ~4.0 GB | Recommended on Macs with 8 GB RAM |
| Gemma 4 E4B | ~9.5 GB | Recommended on 16 GB or more: fastest accurate answers, most natural Icelandic |
| Qwen3.5 9B | ~7.6 GB | 16 GB or more, as accurate as Gemma 4 E4B, a little slower |
| Gemma 4 12B | ~7.7 GB | 16 GB or more, larger Gemma 4 for long documents |
Select a model and click Download Model. SafeRag downloads the chat model and then a small embedding model for searching your documents, showing the progress of each. If the AI runtime is still starting, the screen says so and the list appears a few seconds later.
Onboarding Complete
When the download finishes, the screen shows AI Model Ready with your installed models and the time left in your Pro trial. Click Start Using SafeRag to open the main window.
Free Trial
After onboarding, SafeRag starts a 7-day free trial of all Pro features:
- Unlimited documents and chat sessions
- Watch Folders for automatic indexing
- Up to 5 user accounts
- Audit logging
- Encrypted backups and retention settings
A trial banner appears at the top of the window showing time remaining. When the trial ends, SafeRag continues on the free tier (5 documents, 3 chat sessions, 1 user account), or you can enter a license key to unlock Pro.
Next Steps
You're now ready to use SafeRag! Here's what to explore next: