AI help
Hazel and AI work, in plain words. The same tips as the ? buttons in the app.
Hazel and AI
Which AI should I choose?
Apple Intelligence is free and private, but it's small and can't read handwriting. Your AI key uses Claude, OpenAI or Grok, which do the most and cost a little each time. Local AI is free and runs on your own computer, when it's on and on your Wi-Fi.
Getting a key
Make an account on the company's website, add a way to pay, then create an API key and paste it here. The key stays on this device and never syncs, so each device needs its own.
Setting up local AI
Install LM Studio or Ollama on a computer at home and download a model. Turn on its server so other devices can reach it. Then put the computer's address here and tap Test connection.
Finding your computer's address
On a Mac, open System Settings, then Wi-Fi, then Details, and look for an address like 192.168.1.20. Add :1234 for LM Studio or :11434 for Ollama. If Sunhouse runs on that same Mac, use http://localhost:1234 instead.
Picking a local model
Bigger models are more careful, but slower, and need a computer with more memory. To read recipe cards, pick one that can read photos. Smaller models sometimes get Hazel's changes wrong, and Hazel will tell you when that happens.
Fixing a connection
Check that the computer is awake, the app is open, and its server is on. Both devices need the same Wi-Fi, and the server has to let other devices in: Serve on Local Network in LM Studio, or one setting for Ollama. Then tap Test connection again.
What Sunhouse sends, and never sends
For recipes, Sunhouse sends the recipe's words and card photos, never kids' names or allergies. Meal plans and lesson ideas send first names, allergies and lessons, only if you turn that on. Apple Intelligence keeps it all on this device, and local AI sends only to your computer.
What AI work is
Some things need AI to finish, like an unclear ingredient line or a handwritten card. They wait here until the AI you chose can do them, and nothing is lost while they wait. AI suggests, and you or plain code check it before anything is saved.
How costs and limits work
With your AI key, each request costs a little, and Claude, OpenAI or Grok bills your account. Work that runs on its own stops at your daily limit, and a big batch shows an estimate first. Apple Intelligence and local AI are free.