Configure Google Gemini as Your Hermes Provider
Configure Hermes Agent to use Google's Gemini models directly via Google AI Studio — fast, capable, and cost-effective.
Google Gemini offers excellent performance at competitive prices. Gemini Flash is particularly fast and cheap — great for high-volume tasks. Native integration means no middleman, lower latency, and direct access to Google's latest models.
Managed cloud · API costs included · Skill library · Cancel anytime
Before you start:
- ☑Hermes Agent installed
- ☑Google account
- ☑Google AI Studio API key
Steps
- 1
Get your API key
Go to aistudio.google.com/app/apikey and create an API key
- 2
Add the key to .env
Add GOOGLE_API_KEY=your_key_here to ~/.hermes/.env
- 3
Set the provider
In config.yaml, set model: provider: gemini
- 4
Choose a model
Set model: default: gemini-3-flash (fast) or gemini-3-pro (powerful)
- 5
Test the connection
Run hermes and send a test message
Pro Tips
- 💡Gemini Flash is one of the best auxiliary models — fast and cheap for vision, summarization, and compression
- 💡The GEMINI_API_KEY alias also works if you prefer that name
- 💡Gemini models have excellent context windows (1M+ tokens for some variants)
- 💡Use gemini-3-pro for complex reasoning, gemini-3-flash for speed
Troubleshooting
❌ API key rejected
✅ Verify the key at aistudio.google.com. Ensure you're using a valid API key, not an OAuth token.
❌ Model not found
✅ Check the exact model name. Use 'hermes model' to see available Gemini models.
❌ Rate limited
✅ Google AI Studio has free tier limits. Consider upgrading or using OpenRouter for higher quotas.