hermes-web-tinyfish

Free web search + page fetch for Hermes Agent, powered directly by TinyFish. No Monid CLI required.

curl -fsSL https://raw.githubusercontent.com/misterdas/hermes-web-tinyfish/main/install.sh | bash

The installer copies the plugin, configures both Hermes web tools, and offers to restart the gateway. Set TINYFISH_API_KEY in ~/.hermes/.env first, or export it before running the installer. Get a key at https://agent.tinyfish.ai/api-keys.

What it does

• web_search → https://api.search.tinyfish.ai
• web_extract → https://api.fetch.tinyfish.ai
• Browser-rendered, current results and clean page content
• Zero-cost TinyFish search and fetch
• Uses Hermes' normal web_search and web_extract tools
• Uses Hermes' own cache; fetch requests force ttl: 0 upstream

Manual setup

Copy provider.py, __init__.py, and plugin.yaml to:

~/.hermes/plugins/web/tinyfish/

Then enable and configure the plugin:

hermes plugins enable web/tinyfish --no-allow-tool-override
hermes config set web.search_backend tinyfish
hermes config set web.extract_backend tinyfish
hermes config set web.backend tinyfish
hermes gateway restart

The plugin reads TINYFISH_API_KEY through Hermes' config-aware environment lookup, including ~/.hermes/.env.

Verify

python3 - <<'PY'
import sys
sys.path.insert(0, '/path/to/hermes-agent')
from tools.web_tools import web_search_tool
print(web_search_tool('TinyFish web search', limit=3))
PY

See docs/ for the provider contract and API details.

MIT — LICENSE