"ThunderAI" Setup Guide - Google Gemini
The Google Gemini integration connects ThunderAI to Google's Gemini AI models via the Gemini API.
It includes support for advanced options like System Instructions and thinkingBudget, useful for power users who want more control over the model's behavior.
| API key required | Yes |
| Free option | Yes [Generous free tier available] |
| Best for | Users who prefer Google's ecosystem, or want a free API option |
Prerequisites
- A Google account
- A Gemini API key (free tier available)
- Thunderbird with ThunderAI installed
Getting an API key
- Go to aistudio.google.com/apikey
- Click Create API key
- Select an existing Google Cloud project or create a new one
- Copy the generated API key
The Gemini API has a free tier with generous rate limits, suitable for personal email use. Paid tiers are available if you need higher throughput.
Setup
1. Open ThunderAI Options
In Thunderbird, click the ThunderAI menu and select Options, or go to
Tools → Add-ons and Themes → ThunderAI → Preferences.
2. Select the Google Gemini integration
In the Connection section, choose Google Gemini from the integration dropdown.
3. Enter your API key
Paste your API key in the API Key field.
4. Choose a model
Select the Gemini model from the Model dropdown. Click the button to refresh the list.
5. (Optional) Configure System Instructions
System Instructions let you set a persistent context for all your prompts. For example, telling the model to always respond formally, in a specific language, or to assume a certain role.
Enter your instructions in the System Instructions field on the options page.
6. (Optional) Configure thinkingBudget
The thinkingBudget option controls how much internal reasoning the model does before responding. A higher value can improve quality on complex tasks at the cost of speed and quota. Leave it at the default unless you have specific needs.
7. Save and test
Click Save. Open any email, use the ThunderAI menu, and run a prompt to verify the connection.
Tips
- The free tier is refreshed monthly and is generally sufficient for personal use.
- System Instructions are particularly useful if you need to specify general rules for your email assistant.
Troubleshooting
"API key not valid" error
Verify the key was copied correctly. Regenerate a new key from AI Studio if needed.
"Model not found" or empty model list
Ensure your API key has access to Gemini models. Some keys created in restricted Google Cloud projects may have limited model access.