MnrGreg
hermes-venice-web
Privacy-first web search and scraping plugin for Hermes Agent using Venice AI's zero-data-retention API.
Repository last updated Apr 26, 2026
Overview
The Hermes Venice Web plugin replaces the built-in web_search and web_extract tools in Hermes Agent with privacy-focused alternatives powered by Venice AI. It leverages Venice's /augment/search and /augment/scrape endpoints to provide structured, LLM-friendly output while ensuring zero data retention.
Unlike Venice's always-on web integration methods, this plugin gives the agent explicit control over when to fetch web data. It only calls the tools when the agent decides they are needed, making it ideal for agentic workflows. Because it uses standalone endpoints, it works with any LLM provider—including OpenAI, Anthropic, or local models—not just Venice inference.
Each request costs only $0.01, making it a cost-effective alternative to built-in tools. The plugin is designed for developers who prioritize privacy and want fine-grained control over web access in their Hermes agent pipelines.
Highlights
- Zero data retention with Brave and anonymized Google backends
- Works with any LLM provider via standalone endpoints
- Low cost: $0.01 per search or scrape request
- Structured, LLM-friendly output in Markdown
- Agent decides per-turn whether to search or scrape
Features
Privacy-First Web Search
Uses Venice AI's /augment/search endpoint with zero data retention and anonymized queries.
Privacy-First Web Scraping
Uses Venice AI's /augment/scrape endpoint to fetch clean Markdown content from URLs.
Provider-Independent
Standalone endpoints allow pairing with any AI provider, not just Venice inference.
Explicit Agent Control
Agent decides when to search or scrape, unlike always-on integration methods.
Low Cost
Only $0.01 per request for both search and scrape, plus standard model token pricing.
Installation
Commands are reproduced exactly as published by the project maintainers. Always check the upstream repository for the current instructions.
hermes plugins install mnrGreg/hermes-venice-web --enablemkdir -p ~/.hermes/plugins/venice-web
cd ~/.hermes/plugins/venice-web
# Copy the files below into this folder
hermes plugins reloadecho 'VENICE_API_KEY=vk-XXXXXXXXXXXXXXXX' >> ~/.hermes/.envRequirements
- Hermes Agent installed
- Venice API key (set as VENICE_API_KEY in ~/.hermes/.env)
How it's built
The plugin is written in Python and follows the standard Hermes plugin structure. It consists of plugin.yaml for metadata, tools.py defining the venice_web_search and venice_web_scrape tools, schemas.py for input/output validation, and __init__.py for initialization. The VENICE_API_KEY environment variable is required for authentication.
To install, run hermes plugins install mnrGreg/hermes-venice-web --enable. After installation, you must disable the default Hermes web and browse toolsets in ~/.hermes/config.yaml to avoid conflicts. The plugin integrates seamlessly with the Hermes agent, providing explicit control over web data fetching.
Source
This summary was written for Neura Market from the project's own repository. Install commands, identifiers and licence details are reproduced unchanged. The MnrGreg/hermes-venice-web repository is the authoritative source and the place to file issues or contribute.
Category: Web & Search · Licensed under MIT