- Built-in backend
- Verified plugin
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.
Don't have Hermes Agent yet?
Don't have Hermes Agent yet?
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:
Watch the setup
Watch the setup

Use Tavily from a messaging app
Hermes also runs in Telegram, Discord, Slack, WhatsApp, and Signal. Configure and start the messaging gateway:Built-in tool parameters
web_search
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:- Run
hermes doctorto see the readiness ofweb_searchandweb_extract. - Run
hermes toolsand confirm Tavily is selected if you want to pin it. - Check the active backend:
- If using keyed access, confirm
TAVILY_API_KEYis set in the active profile’s~/.hermes/.env. Avoid printing the key in terminal output. - Keyless access is rate-limited. If the free tier is throttled, add a free Tavily API key for higher limits.