Setup guide
Get your free Gemini key
Wisp needs an AI to answer your questions. Google’s Gemini has a free tier, and getting a key takes about 2 minutes. No credit card needed.
-
Open Google AI Studio
Go to Google AI Studio’s API key page and sign in with your Google account (the same one you use for Gmail or YouTube). The first time, Google asks you to accept its terms.
Open aistudio.google.com/apikey ↗ -
Click “Create API key”
If Google asks you to pick a project, choose the one it suggests or create a new one. Any name works.
-
Copy your key
You’ll see a long code that starts with
AIza. Click the copy button next to it. -
Paste it into Wisp
Open Wisp and click Settings. Next to Run with, choose Gemini. Paste your key into Paste your Gemini API key, then click Save to Keychain.
If your Mac asks whether Wisp can use the Keychain, click Always Allow. That’s where your key is stored safely.
-
Try it
Press ⇧⌘Space, drag over a question anywhere on your screen, and the answer appears right next to it. 🎉
Stuck?
Is it really free?
Yes. Gemini’s free tier has usage limits, so if you ask a lot in a short time, a model can say it’s busy or out of quota. When that happens, Wisp automatically tries your key’s other Gemini models (the “Keep trying other Gemini models” switch in Settings, on by default). Waiting a little also fixes it.
It says “busy”, “overloaded” or “quota”
That’s Google’s free tier being full for a moment, not a problem with your key. Wait a minute and try again, or pick a different model in Settings → Model and click Refresh models.
AI Studio isn’t available for me
Google AI Studio isn’t offered in every country, and Google’s terms require you to be 18 or older. If you can’t use it, Wisp also works with an OpenAI key (pay as you go), or fully offline with Ollama or LM Studio, which are free.
Is my data private on the free tier?
On Gemini’s free tier, Google may use what you send to improve its products, so avoid capturing anything private. For sensitive stuff, run Wisp offline with Ollama or LM Studio, where nothing leaves your Mac.
I think my key leaked. What do I do?
Go back to aistudio.google.com/apikey, delete that key, and create a new one. Then paste the new key into Wisp and click Save to Keychain.
Where do I put my Wisp license key?
That’s a different key! Your Wisp license key comes in your Gumroad receipt email. Paste it on Wisp’s License page.
That’s it. You’re set up ✨
Still stuck? Reply to your Gumroad receipt email and we’ll help.