hermes-ollama-cloud
Ollama Cloud web search and fetch plugin for Hermes Agent.
Uses Ollama Cloud's built-in web search and fetch API as a web_search / web_extract backend. If you already have an Ollama Cloud subscription (e.g. for inference), web search is included at no extra cost — no Tavily, Exa, or Firecrawl key needed.
Ollama vs. Ollama Cloud — This plugin uses Ollama Cloud, Ollama's hosted API service at
ollama.com. It is separate from local Ollama (theollama servedaemon running on your machine). You need an Ollama Cloud account and API key even if you already run local Ollama for inference.In Hermes, the inference provider is called
ollama-cloudand this plugin registers a web backend with the same name. Both use the sameOLLAMA_API_KEY, but they are configured independently — one for chat completions, one for web search/extract.
Install
Option A — pip (recommended)
pip install hermes-ollama-cloud
The package registers itself via the hermes_agent.plugins entry point. Hermes discovers it automatically on next startup — no manual enable step needed.
Option B — manual drop-in
git clone https://github.com/jcmcneal/hermes-ollama-cloud.git ~/.hermes/plugins/ollama-cloud
Then enable it:
hermes plugins enable ollama-cloud
The plugin directory name must be
ollama-cloud(flat, matching the plugin name inplugin.yaml). Hermes does not support nested subdirectories like~/.hermes/plugins/web/ollama.
Configure
1. Set your Ollama Cloud API key
# ~/.hermes/.env
OLLAMA_API_KEY=your-api-key-here
Get your key at ollama.com (sign in → create API key).
You can also set it interactively:
hermes tools
Select Ollama Cloud as your web search and/or web extract provider, and Hermes will prompt for the key.
2. Select ollama-cloud as your web backend
# ~/.hermes/config.yaml
web:
backend: ollama-cloud
Or per-capability:
web:
search_backend: ollama-cloud
extract_backend: ollama-cloud
You can also select it interactively via hermes tools.
API endpoints
| Capability | Endpoint |
|---|---|
| Search | POST https://ollama.com/api/web_search |
| Fetch | POST https://ollama.com/api/web_fetch |
Auth: Bearer token via OLLAMA_API_KEY.
Compatibility
- Hermes Agent v0.13+ (requires the
WebSearchProviderplugin registry) - Python 3.10+
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hermes_ollama_cloud-1.0.1.tar.gz.
File metadata
- Download URL: hermes_ollama_cloud-1.0.1.tar.gz
- Upload date:
- Size: 7.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1ced5138b9e34e9b7770d86a1f064f6d3431a648858b8a6e5ea8a0bbcdb1f3e5
|
|
| MD5 |
0738524d0d923e1ff66b3f4f28e61c67
|
|
| BLAKE2b-256 |
0286b820d62987878e29288e2ce3d39aa317ed9ef51ef71b807761dd0b1ef639
|
Provenance
The following attestation bundles were made for hermes_ollama_cloud-1.0.1.tar.gz:
Publisher:
publish.yml on jcmcneal/hermes-ollama-cloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hermes_ollama_cloud-1.0.1.tar.gz -
Subject digest:
1ced5138b9e34e9b7770d86a1f064f6d3431a648858b8a6e5ea8a0bbcdb1f3e5 - Sigstore transparency entry: 2313873675
- Sigstore integration time:
-
Permalink:
jcmcneal/hermes-ollama-cloud@02ba44df589c170380d7222f217d4d6b8111e7d4 -
Branch / Tag:
refs/tags/v1.0.1 - Owner: https://github.com/jcmcneal
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@02ba44df589c170380d7222f217d4d6b8111e7d4 -
Trigger Event:
push
-
Statement type:
File details
Details for the file hermes_ollama_cloud-1.0.1-py3-none-any.whl.
File metadata
- Download URL: hermes_ollama_cloud-1.0.1-py3-none-any.whl
- Upload date:
- Size: 7.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
55f45f8a9bea3da9d657ed4e81fab237d5eb9b6ea048e00d48aba70916764244
|
|
| MD5 |
ede5d0aec320eafd696465d8b3209f78
|
|
| BLAKE2b-256 |
b33fc7fa8e0ad85b6cf3a21dec415c814d9721447809d244c5b0cee801e57faf
|
Provenance
The following attestation bundles were made for hermes_ollama_cloud-1.0.1-py3-none-any.whl:
Publisher:
publish.yml on jcmcneal/hermes-ollama-cloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hermes_ollama_cloud-1.0.1-py3-none-any.whl -
Subject digest:
55f45f8a9bea3da9d657ed4e81fab237d5eb9b6ea048e00d48aba70916764244 - Sigstore transparency entry: 2313873708
- Sigstore integration time:
-
Permalink:
jcmcneal/hermes-ollama-cloud@02ba44df589c170380d7222f217d4d6b8111e7d4 -
Branch / Tag:
refs/tags/v1.0.1 - Owner: https://github.com/jcmcneal
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@02ba44df589c170380d7222f217d4d6b8111e7d4 -
Trigger Event:
push
-
Statement type:
