Hermes Agent + Gemini 4: 5-Minute Setup, Thinking Levels + Costs

Julian Goldie — founder, AI Profit Boardroom
By Julian Goldie · 8 min read
Get The AI Profit Stack Join AIPB →
🎯 1,000+ done-for-you AI agent workflows 📅 4 live coaching calls every week 🛡️ 7-day refund + 30-day ROI guarantee 👥 3,400+ AI operators inside

Hermes Agent Gemini 4 setup takes about five minutes. Hermes Agent from Nous Research supports Google Gemini natively, and its model list already includes all three Gemini 4 models: Hydrogen, Argon and Carbon. You add a Google API key, run one command to pick the model, and Hermes maps its reasoning settings onto Gemini 4's thinking levels for you. This guide covers the setup, which Gemini 4 model to pick, the costs and the common errors.

📺 Watch: Google Just Released Gemini 4 Hydrogen!

🔥 Get the Agent OS as a free bonus: AI Profit Boardroom members get the full Agent OS zip, prompt libraries, daily tutorials and weekly live coaching calls. → Get inside

Everything here comes from the official Hermes Agent Google Gemini guide and Google's AI Studio model and pricing pages.

Which Gemini 4 Model to Use in Hermes

Model ID in HermesWhat it's forFree tierPrice per 1M tokens (input / output)
gemini-4-hydrogenFast Gemini 4 for everyday coding and agent work; has an xhigh thinking levelYes$1.50 / $7.50
gemini-4-argonEfficient frontier reasoning; 1M shared window and long decodeNo$2 / $10 until 30 Nov 2026, then $4 / $20
gemini-4-carbonGoogle's strongest reasoning model; paid tier onlyNo$2 / $10 until 30 Nov 2026, then $4 / $20

All three have a 1M token context window. For most Hermes users, Hydrogen is the right default. Agents make several model calls per turn, and Hydrogen is the cheapest Gemini 4 model, with a free tier for testing. Google reports it scores 51 on the Artificial Analysis Intelligence Index at default, slightly above Argon's 50. Move to Argon or Carbon for the hardest reasoning tasks.

How to Set Up Hermes Agent With Gemini 4

Step 1: Get a Google API key

Create a key in Google AI Studio. If you want Argon or Carbon, attach it to a billing-enabled Google Cloud project, because neither has a free tier. Hermes recommends billing even for Hydrogen, since agent sessions make several calls per turn and free-tier limits run out fast.

Step 2: Add the key to Hermes

Hermes reads either GOOGLE_API_KEY or GEMINI_API_KEY. Put the key in your Hermes env file at ~/.hermes/.env as a line starting with GOOGLE_API_KEY=. No extra Python package is needed.

Step 3: Pick the provider and model

Run hermes model, choose "More providers", then "Google AI Studio", and select gemini-4-hydrogen, gemini-4-argon or gemini-4-carbon. Hermes probes your key during setup and warns you if it's a free-tier key.

Step 4: Start chatting

Run hermes chat. To switch models mid-session, type /model gemini-4-argon or any other configured model. Use the native IDs like gemini-4-hydrogen, not google/gemini-4-hydrogen.

Your config ends up in ~/.hermes/config.yaml with the provider set to gemini and the base URL set to Google's native v1beta endpoint. If you had an old /openai base URL override, remove it, because Hermes uses Google's native API path.

Want Julian's ready-made Hermes setups, skills and workflows? They're all inside the AI Profit Boardroom, with the Agent OS and weekly live coaching calls.

📺 Watch: Hermes Agent OS Can Automate EVERYTHING?! 🤯

Thinking Levels: How Hermes Maps Reasoning to Gemini 4

Gemini 4 models always think. You set how hard with the /reasoning command or the agent.reasoning_effort config key. For Argon and Carbon, Hermes maps its effort levels like this:

Hermes effortGemini thinkingLevelOutput budget
nonelow, thoughts hiddenNormal per-request cap
minimal, lowlowNormal per-request cap
mediummedium, Google's defaultNormal per-request cap
highhighNormal per-request cap
xhighhigh262,144 tokens with long decode
max, ultrahighAbout 1M tokens minus input, with long decode

Hydrogen works a little differently. It has its own xhigh level, and on Hydrogen the xhigh, max and ultra settings all send xhigh. Google's default for Hydrogen is high.

What long decode means

Without long decode, a single request caps at 65,536 output tokens when streaming and 32,768 when not, thinking included. At xhigh or max, Hermes raises the output limit, and when Gemini replies with a continuation signal, Hermes keeps resending until the model finishes. That lets one answer run far longer. Long decode only works on the AI Studio and Vertex express native endpoints. It doesn't run through OpenRouter, the /openai path or the OAuth Vertex provider.

For Gemini 4 at xhigh and above, Hermes stores the interaction on Google's side. Stored interactions are kept 55 days on paid tiers and 1 day on free tiers.

📺 Watch: Stop Finding Leads Manually! Use Hermes Agent

Using Gemini 4 Through Vertex AI

If your company uses Google Cloud, you can run Gemini 4 in Hermes through Vertex AI express mode. Set GEMINI_BASE_URL to the Vertex AI host. Argon and Carbon only run in the global location, so for those use the v1beta1 projects path with locations/global and your project ID. Vertex express keys start with "AQ." and only work with the Vertex base URL. A mismatch between key and host returns a 403 permission error.

There's also a separate OAuth-based Vertex AI provider in Hermes that needs no API key at all.

What to Build With Hermes Agent and Gemini 4

To compare Gemini 4 with Claude and other models before you pick one, check Goldie Bench. To connect Hermes into a full agent system, follow the Agent OS guide.

Troubleshooting Hermes Agent Gemini 4

Want to skip the trial and error? Join the AI Profit Boardroom to copy Julian's tested Hermes workflows, with daily tutorials and weekly coaching.

FAQ

Does Hermes Agent support Gemini 4?

Yes. The Hermes Gemini provider lists gemini-4-hydrogen, gemini-4-argon and gemini-4-carbon in its model list.

Which Gemini 4 model is best for Hermes Agent?

Hydrogen for most work, because it's the cheapest Gemini 4 model and has a free tier. Use Argon or Carbon for the hardest reasoning.

Can I use Gemini 4 in Hermes for free?

Only Hydrogen has a free tier. Argon and Carbon need a billing-enabled project. Hermes warns that free-tier limits run out quickly in agent sessions.

How do I change thinking level for Gemini 4 in Hermes?

Use the /reasoning command or set agent.reasoning_effort in your config. Hermes maps it to Gemini's thinkingLevel automatically.

Can I use Gemini 4 in Hermes through OpenRouter?

You can use OpenRouter as a provider, but long decode only works on Google's native AI Studio and Vertex express endpoints.

That's the full Hermes Agent Gemini 4 setup: add your key, run hermes model, start with Hydrogen, and move up to Argon or Carbon when a task needs deeper thinking.

What members say about the AI Profit Boardroom

Read all 114 reviews on Skool →

★ 4.9 out of 5 from 114 member reviews on Skool

Yosuke Sato, AI Profit Boardroom member review (5 stars, paying member for 17 months): The best Skool course you get for AI! I have attended a few Skool courses before, but AI Profit Boardroom is the most active community and has great support from the management team, including Julian! You can get the most up-to-date information and practical implementations in this community. I highly recommend this!Mazzie T, AI Profit Boardroom member review (5 stars, paying member for 10 months): My mind is blown everyday with all the content and the incredible information. So much support and I love the personalised attention and quick responses. The community is great and people are very responsive and helpful.Rene Clayton, AI Profit Boardroom member review (5 stars, paying member for 9 months): The AI Profit Boardroom is a GAME CHANGER people. I could not be more thrilled that I joined!! So much support, more information than you can even consume, a huge value for what the small fee was. I have grown my business, my knowledge and my FUN!. SUCH a fantastic leader and group of humans. I am incredibly honored to be a part of this fantastic group of intelligent humans :-) THANK YOU!Arpiet Malpani, AI Profit Boardroom member review (5 stars, paying member for 8 months): Incredible learning from Julian and team. I started out in march and was able to build end to end SAAS with the help and learning from this group. I am incredibly thankful to Julian for crazy support and prompt response.James Grimm, AI Profit Boardroom member review (5 stars, paying member for 7 months): I asked Julian for help finding local business websites with little to no traffic. Julian was gracious in providing me my personal "how-to" video instruction. Wow, this is the pinnacle of customer service! I am just one of 3,400 subscribers and Julian took the time to help me personally. Thank you Julian for your assistance and outstanding custoemr support and care. James (Jim) GrimmNick Good, AI Profit Boardroom member review (5 stars, paying member for 4 months): I’m part of many AI groups and hands down, what Julian Goldie, has built here…the classroom trainings are amazing, but the community he has created is second to none (the community is worth the cost of joining!). If you’re looking to become the AI expert and build/create something meaningful, then AI Profit Boardroom is for YOU!Steven Gray, AI Profit Boardroom member review (5 stars, paying member for 4 months): Been in awhile. I’m a dad on a factory shift, not a tech bloke. Julian’s lot showed me how to use AI without drowning in tools. Avatar, voice, the workflow thinking — that’s what I needed. If you’re stuck on “where do I start,” this group’s worth it. I always read them.Steve Erickson, AI Profit Boardroom member review (5 stars, paying member for 4 months): I asked Julian a simple question, and he ended up creating a 10-minute video and a guide breaking down in extreme detail what I had asked. Amazing response!Rod Martin, AI Profit Boardroom member review (5 stars, paying member for 3 months): Julian is brilliant, and more prolific than I can keep up with (which is a great thing). His AgentOS is remarkable, and he is THE go-to guy for what you can really do (and not do) with the ever-increasing deluge of new AI upgrades and tools. HIGHLY recommend.Daniel Shulman, AI Profit Boardroom member review (5 stars, paying member for 4 months): Julian is very helpful. He doesn't try sell stuff you dont need and will give you a straight answer to your questions.Rj Herzog, AI Profit Boardroom member review (5 stars, paying member for 5 months): Top notch. If you are searching & searching thinking there is always something better out there.... You just found it. No need to look any further. Goldie covers it all & is super helpful. Can't beat the group either. Really can't recommend this group enough.Jermey Matthews, AI Profit Boardroom member review (5 stars, paying member for 6 months): While he has the capacity to do it, Julian is definitely doing the unscalable things to support his community.

Ready To Join The #1 AI Community?

Join 3,400+ entrepreneurs inside the AI Profit Boardroom. Get the Agent OS, 1,000+ plug-and-play AI agent workflows, daily Q&A with Julian and 4 live coaching calls every week.

Join The AI Profit Boardroom →

7-Day No-Questions Refund • 30-Day ROI Guarantee

← Back to all posts