dennii/Hermes-Ollama_Models
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: support physical and Docker Ollama runtimes

Browse Source
This commit is contained in:
Hermes Agent
2026-08-24 20:22:22 +10:00
parent 9f2be5b368
commit 7def2990ce
5 changed files with 95 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+25
View File
@@ -57,6 +57,31 @@ https://gitea.beyondcloud.solutions/dennii/Hermes-Ollama_Models.git
In Hermes Dashboard, open **Plugins**, choose **Install from repository**, enter the URL above, and install. The repository contains the root `plugin.yaml`, dashboard manifest, backend API, compiled frontend bundle, stylesheet, and an opt-in prerequisite declaration. On Linux, the Hermes installer will verify Ollama, install it with the official Ollama installer when missing, and install the plugin's `pypdf` dependency before committing the plugin into `~/.hermes/plugins/`. Ollama installation requires the Hermes container to run as root, which is the expected configuration for a privileged ZimaOS deployment. If the container is not running as root, the plugin install stops without enabling a partially configured plugin. After installation or an update, restart only the Hermes dashboard service if requested by the installer.
## Physical and Docker deployments
The plugin supports both deployment types:
- **Physical/Linux Hermes:** Ollama defaults to `http://localhost:11434`. If Ollama is missing, the prerequisite installer can install it on a root-run host.
- **Docker Hermes:** Ollama should normally run as a separate service or on the Docker host. The plugin does not install Ollama inside the Hermes container. Set `OLLAMA_HOST` to the reachable Ollama base URL, without `/v1`, for example `http://ollama:11434` for a Compose service or `http://host.docker.internal:11434` for a host service.
For host access on Linux Docker, add this to the Hermes service when needed:
```yaml
extra_hosts:
- "host.docker.internal:host-gateway"
environment:
OLLAMA_HOST: http://host.docker.internal:11434
```
For Compose service-to-service networking, use the Ollama service name instead:
```yaml
environment:
OLLAMA_HOST: http://ollama:11434
```
The dashboard plugin API is mounted when the dashboard starts. Restart Hermes after installing or enabling the plugin; otherwise the plugin page can load while `/api/plugins/ollama-manager/status` still returns 404.
## Security limits
- Uploaded files are limited to 20 MiB each