Skip to main content
Hermes Agent is Nous Research’s open-source agent for the terminal and messaging apps. Use Tavily as Hermes’s built-in web backend, which works without an API key, or install the verified Tavily plugin for the full Tavily toolset.
Tavily powers Hermes’s own web_search and web_extract tools. Keyless access is free and rate-limited, and an API key gives you higher limits.
1

Select Tavily as the web backend

Run the interactive tool setup, select Tavily, and skip the API key prompt:
Or set the backend directly:
Select Tavily explicitly. Hermes’s default keyless rotation (round-robin) doesn’t include Tavily; it rotates across the free tiers of Exa, Parallel, Firecrawl, and Keenable.
On Linux, macOS, WSL2, or Termux:
On native Windows, in PowerShell:
Follow the Hermes setup flow to configure your model provider.
2

Add an API key (optional)

For higher limits, save a key and pin Tavily as the backend:
Get a free API key with 1,000 monthly credits from the Tavily dashboard. Hermes stores secrets such as TAVILY_API_KEY in ~/.hermes/.env.
3

Verify

Check the configured web tools, then start Hermes:
Ask it to run a live search:
Setting up Tavily in Hermes Agent

Use Tavily from a messaging app

Hermes also runs in Telegram, Discord, Slack, WhatsApp, and Signal. Configure and start the messaging gateway:
Once your platform is connected, web search and extraction work through the same Hermes tools used in the terminal.

Built-in tool parameters

web_extract

For long pages, Hermes returns a bounded head-and-tail excerpt and stores the complete extracted text locally so the agent can read the omitted sections when needed.

Example prompts

Troubleshooting

If Hermes cannot search or extract content, check these in order:
  1. Run hermes doctor to see the readiness of web_search and web_extract.
  2. Run hermes tools and confirm Tavily is selected if you want to pin it.
  3. Check the active backend:
  4. If using keyed access, confirm TAVILY_API_KEY is set in the active profile’s ~/.hermes/.env. Avoid printing the key in terminal output.
  5. Keyless access is rate-limited. If the free tier is throttled, add a free Tavily API key for higher limits.

Learn more