Supported AI · Nous Research
What is Hermes Agent?
Hermes Agent is a free, open-source AI agent from Nous Research that you install on your own computer or server. You choose the AI model and pay that provider. It can search and browse the web, run scheduled jobs, chat with you on Telegram, Slack and other apps, and use skills, which are folders with a SKILL.md file.
Last checked · Sources
Who can use it
- Free and open source (MIT)
- Linux, Apple Silicon Mac, Windows or WSL2
- Your own model key, or a Nous Portal account
- Some setup in a terminal
- Scheduled jobs need the gateway running
Hermes Agent at a glance
Each fact links to the page it comes from, with the day we last checked that page.
| Fact | What the docs say |
|---|---|
| Where it runs | Your own computer or server: Linux, Apple Silicon Mac, Windows or WSL2, through a terminal, desktop app or chat appsSource: Installing Hermes Agent(opens in a new tab)Checked |
| Connect apps | Gmail, Google Calendar, Drive, Sheets and Docs through the bundled Google Workspace skill; built-in web search and browser; Telegram, Slack, WhatsApp and other chat appsSource: Hermes Agent Google Workspace skill(opens in a new tab)Checked |
| Schedules | Built-in cron jobs, created in plain language, with /cron add or with hermes cron create; the gateway must be runningSource: Hermes Agent scheduled tasks (cron)(opens in a new tab)Checked |
| Plan | Free and open source (MIT); you pay only for model usage, through your own provider key or Nous PortalSource: Hermes Agent FAQ(opens in a new tab)Checked |
| Availability | No country limits in the official docs; your model provider's terms applySource: Hermes Agent FAQ(opens in a new tab)Checked |
What Hermes Agent can do
Skills from SKILL.md folders
Hermes skills follow the agentskills.io standard. Save one in ~/.hermes/skills/ and it becomes a slash command with the skill's name. Hermes can also write and improve its own skills as it works.
Example: /meeting-recap Turn these notes into decisions and actions.
Scheduled jobs
Ask in plain language or use /cron add to run a task on a schedule, such as every Monday at 9am. Each run starts a fresh session, so the job's instructions must be complete, and the result can go to a chat app such as Telegram.
Example: Every Monday at 9am, summarize last week's support requests and send me the summary on Telegram.
Web, browser and Google Workspace
Web search works on a fresh install, and a browser tool reads pages that need the live page. The bundled Google Workspace skill connects Gmail, Calendar, Drive, Sheets and Docs through your own Google Cloud project.
Example: Search the web for this company's latest news and list the sources with dates.
Get started with Hermes Agent
- Install Hermes from the official installation page: a one-line command for Linux, Apple Silicon Macs or WSL2, a PowerShell command for Windows, or the desktop app.
- Run hermes setup. Quick Setup signs you in to Nous Portal; Full Setup lets you add your own key for OpenRouter, OpenAI, Anthropic, Google or another provider.
- Connect only what the task needs. Ask Hermes to set up Google Workspace for Gmail, Calendar or Sheets, and run hermes gateway setup to chat on Telegram, Slack or another app.
- Pick a skill or recipe below. Save a skill as ~/.hermes/skills/<skill-name>/SKILL.md, start a new chat and call it with / and the skill's name.
- For scheduled work, keep the gateway running, create the job with /cron add or a plain request, and check the first result before you rely on it.
What to check before you trust it
- Start read-only: ask for lists and drafts before you let Hermes send, edit or delete anything.
- The Google Workspace skill can send email and write to Sheets, and its setup page states no confirmation rule, so keep recipe prompts draft-only.
- Keep approvals on. The default smart mode asks a second model to judge risky shell commands, and scheduled jobs deny them; setting approvals to off disables all safety prompts.
- Read a third-party skill before you install it. Hermes scans Skills Hub installs, but a scan is not a review.
- Test with a fictional sample before you connect real accounts. Scheduled jobs run only while the gateway is running.
We have not run these setups ourselves. Recipes are written from public Hermes Agent documentation, and their examples are illustrative.
Recipes built with Hermes Agent (7)
A recipe is a step-by-step setup you build in Hermes Agent yourself. Each one shows what you provide, what you get, and a setup prompt to copy. Examples are illustrative, not recorded results.
Cash Flow Planner
Finance & Accounting
Build a 13-week cash flow forecast from your bank balance, invoices and bills
Customer Answer Drafter
Customer Support
Answer customer questions from your FAQ, prices and policies
Win-Back Drafter
Sales & CRM
Win back customers who have gone quiet
Applicant Keeper
HR & People
Track job applicants in a sheet from Gmail
Pipeline Keeper
Sales & CRM
Keep your lead pipeline in a sheet from Gmail
Outreach Planner
Sales & CRM
Plan your LinkedIn outreach in a Google Sheet
Time Off Keeper
HR & People
Keep a PTO tracker in Google Sheets from time off emails
Skills you can add to Hermes Agent (70)
A skill is a folder of instructions that Hermes Agent can use for a specific task. Add it once, then ask for the task in your own words.
Sales call follow-up
Turn call notes into a recap email that promises only what was agreed, proposed CRM changes and a task list with owners and dates.
Account reconciliation
Compare accounting records with a clear audit trail, separate uncertain matches, and explain remaining differences.
Research synthesis
Combine supplied sources into a clear answer that preserves evidence, disagreement, and uncertainty.
Document field extraction
Extract requested fields into a source-linked table without guessing missing or unreadable values.
Prospect fit research
Check a named company against your customer criteria and return a sourced fit brief.
Business process documentation
Turn team notes into a repeatable process with clear owners, decisions, exceptions, and completion checks.
AI job search
Find current job openings, drop duplicates and expired posts, and shortlist them against your must-haves and real experience.
Applicant tracker from email
Log job applications from Gmail or Outlook in a Google Sheet or CSV, and see which applicants are waiting for your reply.
Article-to-Visuals
Map an approved article to a cover, three illustrations and an optional six-card carousel, exported as editable SVG, PNG and PDF files.
Audio edit plan
Create a cut and keep plan from a transcript while protecting the speaker’s meaning.
Budget versus actual review
Compare budget and actual figures on the same basis and explain only supported differences.
Bug diagnosis
Trace a failure to its first broken invariant, test competing causes and verify a minimal authorized fix.
Questions about Hermes Agent
- Is Hermes Agent free?
- Hermes Agent is free and open source under the MIT license. You pay only for the AI model it uses, through your own provider key or a Nous Portal account; local models cost nothing to run.
- Can Hermes Agent use JuicyAgents skills?
- Yes. Hermes skills follow the agentskills.io standard, and our skills have the name and description it needs. Save the SKILL.md in ~/.hermes/skills/<skill-name>/, start a new chat and call it with / and the skill's name.
- Can Hermes Agent read my Gmail?
- Yes, through the bundled Google Workspace skill. Ask Hermes to set up Google Workspace: you create a Google Cloud project and a Desktop app OAuth client, then approve access in your browser. For email only, the himalaya skill works with a Gmail app password.
- Can Hermes Agent run tasks on a schedule?
- Yes. Ask in plain language, such as every Monday at 9am, or use /cron add. Jobs run only while the gateway is running, and each run starts a fresh session.
- Does Hermes Agent ask before it acts?
- Its approvals cover risky shell commands, and scheduled jobs deny them by default. The Google Workspace skill can still send email or edit Sheets, so the recipes here tell Hermes to prepare drafts only.
Get new templates and agents by email
New free templates, and AI agents you can set up in the AI you already pay for.
Sign up for occasional JuicyAgents emails about new agent guides and useful workflows. We will use your email only for these updates. You can unsubscribe from any email. Privacy policy
Sources
The pages behind Hermes Agent’s facts and setup steps, with the day we last checked each one.
All sources (16)
- Hermes Agent cron troubleshooting(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent FAQ(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent Google Workspace skill(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent google-workspace SKILL.md(opens in a new tab)github.com · Checked
- Hermes Agent messaging gateway(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent quickstart(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent scheduled tasks (cron)(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent security(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent skills(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent tools(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Installing Hermes Agent(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Automate anything with cron(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent configuration(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Hermes Agent repository(opens in a new tab)github.com · Checked
- Hermes Agent web search(opens in a new tab)hermes-agent.nousresearch.com · Checked
- Using OAuth 2.0 to access Google APIs(opens in a new tab)developers.google.com · Checked
Compare Hermes Agent with
OpenClawOpenClaw Foundation
Claude CodeAnthropic
n8n