mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-11-17 11:22:02 +03:00
Merge origin/main (#24: 91 commits to f549953a38) into feat/unified-gateway-runtime
No conflicts.
This commit is contained in:
@@ -25,7 +25,7 @@ on:
|
||||
type: string
|
||||
default: ''
|
||||
tag:
|
||||
description: "Exact stable tag (vX.Y.Z) under release. The caller is dispatched on this tag, so github.sha is the release candidate."
|
||||
description: "Attempt ref (rc.N-vX.Y.Z) under release; the versioned images carry this tag. The caller is dispatched on it, so github.sha is the release candidate."
|
||||
required: false
|
||||
type: string
|
||||
default: ''
|
||||
|
||||
@@ -152,21 +152,26 @@ jobs:
|
||||
- name: nix flake check
|
||||
# --print-build-logs: a check that fails then prints the assertion
|
||||
# that failed, and not only the derivation that failed to build.
|
||||
run: nix flake check "${{ inputs.release == true && format('path:{0}/release-source', runner.temp) || '.' }}" --print-build-logs
|
||||
# A path: flake has no git metadata, so the release source names its
|
||||
# commit with ?rev=: without it self.rev is null, the install stamp
|
||||
# carries no commit, and the packaged CLI reports "unknown".
|
||||
run: nix flake check "${{ inputs.release == true && format('path:{0}/release-source?rev={1}', runner.temp, github.sha) || '.' }}" --print-build-logs
|
||||
|
||||
- name: Verify release package runtime identity
|
||||
if: inputs.release == true
|
||||
env:
|
||||
RELEASE_VERSION: ${{ inputs.version }}
|
||||
run: |
|
||||
source="path:$RUNNER_TEMP/release-source"
|
||||
source="path:$RUNNER_TEMP/release-source?rev=$GITHUB_SHA"
|
||||
package="$(nix build "$source#default" --no-link --print-out-paths)"
|
||||
actual="$("$package/bin/hermes" --version)"
|
||||
ACTUAL_VERSION="$actual" python3 - <<'PY'
|
||||
import os
|
||||
|
||||
expected = os.environ["RELEASE_VERSION"]
|
||||
actual = os.environ["ACTUAL_VERSION"].split()[-1].removeprefix("v")
|
||||
# Line one is "Hermes Agent v<version> (...)"; later lines (Python, OpenAI SDK) carry other versions.
|
||||
first = os.environ["ACTUAL_VERSION"].splitlines()[0].split()
|
||||
actual = first[2].removeprefix("v") if first[:2] == ["Hermes", "Agent"] and len(first) > 2 else ""
|
||||
if actual != expected:
|
||||
raise SystemExit(f"Nix package version mismatch: expected {expected}, got {actual}")
|
||||
PY
|
||||
|
||||
@@ -87,7 +87,7 @@ jobs:
|
||||
with:
|
||||
release-phase: test
|
||||
skip-tests: ${{ needs.admit.outputs.skip-tests == 'true' }}
|
||||
tag: ${{ needs.admit.outputs.tag }}
|
||||
tag: ${{ needs.admit.outputs.claim-tag }}
|
||||
version: ${{ needs.admit.outputs.version }}
|
||||
|
||||
nix:
|
||||
@@ -523,7 +523,7 @@ jobs:
|
||||
secrets: inherit
|
||||
with:
|
||||
release-phase: publish
|
||||
tag: ${{ needs.admit.outputs.tag }}
|
||||
tag: ${{ needs.admit.outputs.claim-tag }}
|
||||
version: ${{ needs.admit.outputs.version }}
|
||||
|
||||
publish-bundles:
|
||||
|
||||
@@ -89,18 +89,20 @@ test('Store calendar ordering survives minute, hour, day and year boundaries and
|
||||
test('stable candidate identity uses the admitted claim epoch before the final tag exists', () => {
|
||||
const { root, app } = fixture()
|
||||
execFileSync('git', ['tag', '-d', 'v0.27.1'], { cwd: root, stdio: 'pipe' })
|
||||
execFileSync('git', ['tag', '-a', 'v0.27.1-rc', '-m', 'claim'], {
|
||||
execFileSync('git', ['tag', '-a', 'rc.3-v0.27.1', '-m', 'claim'], {
|
||||
cwd: root,
|
||||
env: { ...process.env, ...gitIdentityEnv, GIT_COMMITTER_DATE: '2026-09-07T00:18:00Z' },
|
||||
stdio: 'pipe'
|
||||
})
|
||||
const epoch = Date.parse('2026-09-07T00:18:00Z') / 1000
|
||||
vi.stubEnv('RELEASE_CLAIM_TAG', 'v0.27.1-rc')
|
||||
vi.stubEnv('RELEASE_CLAIM_OBJECT', execFileSync('git', ['rev-parse', 'v0.27.1-rc'], {
|
||||
vi.stubEnv('RELEASE_CLAIM_TAG', 'rc.3-v0.27.1')
|
||||
vi.stubEnv('RELEASE_CLAIM_OBJECT', execFileSync('git', ['rev-parse', 'rc.3-v0.27.1'], {
|
||||
cwd: root, encoding: 'utf8'
|
||||
}).trim())
|
||||
try {
|
||||
expect(appIdentity(app, 'v0.27.1').version).toBe(storePackageVersionAt(epoch))
|
||||
vi.stubEnv('RELEASE_CLAIM_TAG', 'rc.3-v0.27.10')
|
||||
expect(() => appIdentity(app, 'v0.27.1')).toThrow('Stable claim tag differs from its payload tag')
|
||||
} finally {
|
||||
vi.unstubAllEnvs()
|
||||
}
|
||||
|
||||
@@ -0,0 +1 @@
|
||||
Kame696
|
||||
@@ -0,0 +1 @@
|
||||
capthvnsen
|
||||
@@ -0,0 +1 @@
|
||||
d8joseph
|
||||
@@ -0,0 +1 @@
|
||||
berthelius
|
||||
@@ -0,0 +1 @@
|
||||
NanamiMio
|
||||
@@ -917,8 +917,10 @@ def _get_plugin_toolset_key(name: str) -> Optional[str]:
|
||||
|
||||
|
||||
def _toggle_plugin_toolset(name: str, *, enable: bool) -> None:
|
||||
"""Add/remove a plugin's toolset in ``platform_toolsets`` for all platforms (no-op when the
|
||||
plugin provides no tools)."""
|
||||
"""Add/remove a plugin's toolset in every SAVED ``platform_toolsets`` list (no-op when the plugin
|
||||
provides no tools). Platforms with no saved list are left alone: a plugin toolset is already on
|
||||
there by default, and seeding ``[<plugin_ts>]`` would replace the core composite and strip every
|
||||
built-in tool."""
|
||||
toolset_key = _get_plugin_toolset_key(name)
|
||||
if not toolset_key:
|
||||
return
|
||||
@@ -935,10 +937,6 @@ def _toggle_plugin_toolset(name: str, *, enable: bool) -> None:
|
||||
(ts_list.append if enable else ts_list.remove)(toolset_key)
|
||||
platform_toolsets[platform] = ts_list
|
||||
changed = True
|
||||
# Enabling with no platform lists yet: seed "cli" at minimum.
|
||||
if enable and not changed and not platform_toolsets:
|
||||
platform_toolsets["cli"] = [toolset_key]
|
||||
changed = True
|
||||
if changed:
|
||||
save_config(config)
|
||||
|
||||
|
||||
@@ -133,8 +133,7 @@ def _remove_user_plugin(plugins_dir: Path, name: str, target: Path) -> dict[str,
|
||||
entry = next((e for e in _pc()._discover_all_plugins() if Path(str(e[4])) == target), None)
|
||||
key = entry[5] if entry else target.name
|
||||
aliases = _pc()._plugin_aliases(key) | {target.name}
|
||||
if _pc()._read_manifest(target).get("provides_tools"):
|
||||
_pc()._toggle_plugin_toolset(key, enable=False)
|
||||
_pc()._toggle_plugin_toolset(key, enable=False)
|
||||
_remove_plugin_core(target)
|
||||
return {"ok": True, "name": name, **_pc()._forget_plugin_config(aliases)}
|
||||
|
||||
|
||||
@@ -0,0 +1,24 @@
|
||||
name: alans-way-computer
|
||||
repo: https://github.com/capthvnsen/alans-way-agents
|
||||
sha: ce51733b66291e69f616db48ae8799c0de50db43
|
||||
subdir: alans-way-computer
|
||||
version: "0.7.0"
|
||||
title: "Alan's Way Computer"
|
||||
description: "Computer-use provider for Hermes: the stock computer_use tool drives desktop apps on the user's computer through the Alan's Way app, and on the VM's own desktop when the computer is offline. Needs the alans-way plugin's workspace setup. Select it with computer_use.backend: alans-way-computer. Disclosure — starts the workspace router from the profile's mcp_servers.workspace_browser block (command and args from config.yaml, with a filtered environment plus HERMES_WORKSPACE_ALLOW_DESKTOP_ACTIONS=1, which lets this private router child serve desktop input) as a long-running node child per session. It talks to the router over stdio (app lists, element trees, screenshots and input actions). The router reaches the user's computer over SSH on the user's tailnet and falls back to the VM's desktop. The provider never takes the focused window, and every input action still goes through Hermes's computer_use approval gate (cua:*:background entries in command_allowlist, which alans-way's --allow-desktop-actions adds, skip the prompt). On Hermes 0.21.5, which has no provider API, it installs and does nothing."
|
||||
maintainer: capthvnsen
|
||||
tier: community
|
||||
category: tools
|
||||
requires_hermes: ">=0.21.5"
|
||||
docs_url: https://github.com/capthvnsen/alans-way-agents/tree/ce51733b66291e69f616db48ae8799c0de50db43/alans-way-computer
|
||||
readme: true
|
||||
platforms: [linux, macos]
|
||||
known_issues:
|
||||
- "Needs a Hermes build with the pluggable computer-use API (merged to main after 0.21.5). On older Hermes the plugin installs and does nothing. Install alans-way first and run its workspace setup, which writes the workspace_browser block this provider reuses."
|
||||
- "Hermes asks for approval on every computer_use action type until it is granted. For an unattended Telegram bot, grant them once with Always in Telegram, or add cua:<action>:background entries to command_allowlist (see the README). Takes effect after a gateway restart."
|
||||
- "Runs only in the plugin host: it cannot load under plugins.isolation: host, because the provider hands Hermes a live router session."
|
||||
- "Typing without a target field is not available because the app never takes focus: the agent uses set_value on a field instead."
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks: []
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
@@ -0,0 +1,26 @@
|
||||
name: alans-way
|
||||
repo: https://github.com/capthvnsen/alans-way-agents
|
||||
sha: ce51733b66291e69f616db48ae8799c0de50db43
|
||||
subdir: alans-way
|
||||
version: "0.7.0"
|
||||
title: "Alan's Way"
|
||||
description: "Idle check-ins from the primary bot of a Hermes gateway on a Linux machine or a macOS guest VM: when the bound Telegram chat has been quiet for two hours, during 08:00-22:00 in the user's timezone, the bot checks in once (does one safe step and reports it, suggests one, or asks one question), backing off when unanswered. The model tool can only make check-ins quieter; more often, resume and wider hours are operator-only via /proactivity or the CLI. After install, the workspace-setup skill walks the agent through a separate companion app and Tailscale setup on the user's computer (macOS, Windows or Linux); desktop input goes only through Hermes's approval-gated computer_use tool. Disclosure — once the gateway connects Telegram, a background thread checks every 60 seconds. When the bound Telegram DM has been quiet (2 h by default, doubling per unanswered check-in, 08:00-22:00 user time), it injects an internal user-role prompt into that chat (needs plugins.entries.alans-way.allow_gateway_injection, which setup sets), so the bot runs a turn on its own and may take one \"safe, reversible\" step; the user still approves tool calls in Telegram. Its pre_llm_call/post_llm_call hooks see every session's turns and store only the bound chat's timestamps in plugin state. On first load it reads $HERMES_HOME/companion/proactivity/proactivity.sqlite3 once, read-only. The workspace-setup skill has the agent clone this repo at the catalog pin and run setup.sh, which: installs long-running services (Linux systemd units hermes-alans-way-chromium/-browser with loginctl enable-linger and a mac-watch.service with Restart=always; a KeepAlive LaunchAgent on a macOS guest; logon Scheduled Tasks on Windows); adds a TimeoutStartSec=180 drop-in to the hermes-gateway unit and restarts the gateway from a transient systemd-run timer; appends the user's computer's public key to ~/.ssh/authorized_keys (administrators_authorized_keys on a Windows admin account), pins its host key in known_hosts and adds a ControlMaster block to ~/.ssh/config, for Tailscale hosts only; for the main profile and every profile with its own Telegram bot, writes a managed mcp_servers.workspace_browser block (removing other entries that run this router, with a backup), turns off the built-in browser toolset for Telegram and cron, and turns computer_use back on for Telegram and cron; and reads each profile's TELEGRAM_BOT_TOKEN only to derive the numeric bot id. The workspace router reaches the user's computer over SSH on their tailnet. The companion setup page has the human run the alans-way connect script from its main branch on their own computer, and the agent may install Tailscale with its official install script. Desktop input goes through Hermes's approval-gated computer_use tool. The manual --allow-desktop-actions setup flag, which the skill offers but never adds itself, adds cua:*:background entries to command_allowlist. On a Hermes without the computer-use provider API, including 0.21.5, it also exposes workspace_computer_action, which drives the user's desktop, Terminal included, with no approval."
|
||||
maintainer: capthvnsen
|
||||
tier: community
|
||||
category: automation
|
||||
requires_hermes: ">=0.21.5"
|
||||
docs_url: https://github.com/capthvnsen/alans-way-agents/tree/ce51733b66291e69f616db48ae8799c0de50db43/alans-way
|
||||
readme: true
|
||||
platforms: [linux, macos]
|
||||
known_issues:
|
||||
- "Install this on the machine that runs Hermes (a Linux host or a macOS guest VM), not on the user's primary computer. Windows guests are new and untested on real hardware. If the plugin is already installed from the catalog, setup leaves it as it is, so this pin stays."
|
||||
- "Setup turns off Hermes's stock browser toolset for Telegram and cron so the agent uses the workspace browser (pass --keep-browser to leave it on). It never turns off computer_use: on Hermes with the computer-use provider API, desktop input goes through the gated computer_use tool and its alans-way-computer provider."
|
||||
- "Check-ins need plugins.entries.alans-way.allow_gateway_injection: true and a bound Telegram DM (setup does both). A background thread checks every 60 seconds once the gateway connects Telegram."
|
||||
capabilities:
|
||||
provides_tools:
|
||||
- proactivity
|
||||
provides_hooks:
|
||||
- pre_llm_call
|
||||
- post_llm_call
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
@@ -0,0 +1,35 @@
|
||||
name: aphrodite
|
||||
repo: https://github.com/PlayForm/Aphrodite-Hermes
|
||||
sha: e95afcd9d99360fdf73ecdd2f540af7cd81597ec
|
||||
description: "CCR compression plugin - 28-type classifier, 13 tools, opt-in context engine, TOML-driven templates. Disclosure - pre_tool_call auto-backgrounds long terminal/process commands (modify: background=true, notify_on_complete=true) and rewrites chained terminal commands when enabled. Disclosure — hook and tool logic runs in prebuilt native binaries (libaphrodite_hermes + aphrodite proxy, v1.6.6) built from the public PlayForm/Aphrodite source and fetched by an explicit download.sh step checked against in-tree SHA-256 sums; register() starts a background proxy on 127.0.0.1:9797/9798 whose management routes are open to local processes unless APHRODITE_MGMT_TOKEN is set; pre_tool_call by default rewrites slow terminal commands (cargo/npm/pip/docker/curl…) to run in the background (background=true, notify_on_complete=true) and splits chained commands when enabled; aphrodite_prefetch reads files the model names into its store (refuses .env, auth.json, ~/.ssh and the Hermes home); requires its own APHRODITE_API_KEY for an upstream LLM endpoint (default api.openai.com)."
|
||||
maintainer: NikolaRHristov
|
||||
tier: community
|
||||
category: tools
|
||||
requires_hermes: ">=0.20.2"
|
||||
docs_url: https://github.com/PlayForm/Aphrodite-Hermes#readme
|
||||
version: "2.2.6"
|
||||
capabilities:
|
||||
provides_tools:
|
||||
- aphrodite_retrieve
|
||||
- aphrodite_compress
|
||||
- aphrodite_stats
|
||||
- aphrodite_rebuild
|
||||
- aphrodite_files
|
||||
- aphrodite_diff
|
||||
- aphrodite_search
|
||||
- aphrodite_directive
|
||||
- aphrodite_test
|
||||
- aphrodite_catalog
|
||||
- aphrodite_reclassify
|
||||
- aphrodite_prefetch
|
||||
- aphrodite_prefetch_status
|
||||
provides_hooks:
|
||||
- on_session_start
|
||||
- transform_tool_result
|
||||
- pre_llm_call
|
||||
- transform_terminal_output
|
||||
- post_llm_call
|
||||
- pre_tool_call
|
||||
provides_middleware: []
|
||||
requires_env:
|
||||
- APHRODITE_API_KEY
|
||||
@@ -0,0 +1,21 @@
|
||||
name: commandcode-oauth
|
||||
repo: https://github.com/NanamiMio/hermes-commandcode-oauth
|
||||
sha: 232f2d14d96ad4197a596feaec309c43c6aa9c84
|
||||
description: Command Code CLI-key model provider with live setup discovery, plan limits and failover classification. Disclosure — uses the CLI-internal api.commandcode.ai/alpha/generate endpoint and CLI client headers, sends the full conversation, tool schemas, cwd path and OS/Python version, and imports a static key from the read-only CLI credential file or a browser hand-off; no OAuth exchange takes place. Hermes also bundles commandcode for the documented Provider API.
|
||||
maintainer: NanamiMio
|
||||
tier: community
|
||||
category: models
|
||||
requires_hermes: ">=0.21.5"
|
||||
docs_url: https://github.com/NanamiMio/hermes-commandcode-oauth#readme
|
||||
version: "0.1.2"
|
||||
readme: true
|
||||
platforms: []
|
||||
known_issues:
|
||||
- Requires Hermes main containing f12e6b66d960a92d9d4779cfcc628ab9cb02555b (generic plugin OAuth auxiliary routing); the September 24, 2026 release lacks it.
|
||||
- Live /model and Desktop catalog probing for non-api_key profiles depends on upstream PR 122203; hermes model setup already fetches the live account catalog.
|
||||
- Older cores may incorrectly warn about this provider's vendor/model IDs in hermes doctor; generic profile namespace support is proposed in upstream PR 134900.
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks: []
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
@@ -0,0 +1,17 @@
|
||||
name: diaktoros
|
||||
repo: https://github.com/coe0718/diaktoros
|
||||
sha: 64dd33746733d7ab5823ec56de8f12051c988ccc
|
||||
description: "Unattended GitHub pull-request review between two Hermes agents: one pushes fixes, a different one reviews, rounds are capped in verdicts, a watchdog reports silent stalls, and the loop never merges. Disclosure — runs unattended Hermes agent turns inside bubblewrap (terminal and file tools, no network, no credentials); a host-side broker and the CLI write to GitHub (reviews, comments, labels, issues, repo webhooks, and opt-in fixer pushes, which may push CI fixes and merge commits of the base into a PR's own branch to resolve conflicts; it never merges a PR) with repo-scope PAT files you provide; edits Hermes's webhook_subscriptions.json directly and its watchdog re-adds this loop's routes while armed; writes gate scripts into the seat profiles' scripts/ folders and creates one hermes cron job (its migrate command replaces the old hermes-review-loop job and copies that plugin's settings); downloads PR archives from codeload.github.com, failed CI job logs from GitHub's log storage (redirected, without the token) and Rust crates from crates.io on the host; an opt-in observer feed posts loop notices to the chat you name; deletes its own state and closed-PR review dirs in roots you configure; on OAuth seats its host proxy may force Hermes token refreshes that rewrite ~/.claude, ~/.codex, ~/.qwen and profile auth.json credentials, and on Claude subscription logins it identifies as Claude Code (Claude Code user-agent, x-app and OAuth beta headers). Nothing runs until you arm a loop. Linux only."
|
||||
maintainer: coe0718
|
||||
tier: community
|
||||
category: automation
|
||||
requires_hermes: ">=0.21.5"
|
||||
docs_url: https://github.com/coe0718/diaktoros#readme
|
||||
version: "0.2.0"
|
||||
platforms:
|
||||
- linux
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks: []
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
@@ -1,18 +1,18 @@
|
||||
name: echarts-in-chat
|
||||
repo: https://github.com/Tommy00748/hermes-plugin-echarts-in-chat
|
||||
sha: 5e0924c528c4e4bd100c87f913f79300f8de2605
|
||||
sha: 6825178e277604594cd0a9b8f2789208e40ba59b
|
||||
description: "Render a chart inline in the Hermes Desktop transcript: the model emits ::echarts{labels=... values=...} and the plugin mounts an interactive SVG chart (dataZoom slider, click-to-filter legend, resize-aware, 280-560px height clamp) in the plugin SDK's transcript-directive slot. Disclosure — no network calls, no shell commands, no stored credentials, no environment variables, no background processes, and nothing read or written outside the message it renders; the chart is drawn locally as inline SVG with no third-party libraries."
|
||||
maintainer: Tommy00748
|
||||
tier: community
|
||||
category: desktop
|
||||
requires_hermes: ">=0.21.5"
|
||||
docs_url: https://github.com/Tommy00748/hermes-plugin-echarts-in-chat#readme
|
||||
version: "2.0.0"
|
||||
version: "2.1.0"
|
||||
title: ECharts in Chat
|
||||
screenshots:
|
||||
- https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/5e0924c528c4e4bd100c87f913f79300f8de2605/docs/echarts-in-chat-bar-line.png
|
||||
- https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/5e0924c528c4e4bd100c87f913f79300f8de2605/docs/echarts-in-chat-trend.png
|
||||
- https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/5e0924c528c4e4bd100c87f913f79300f8de2605/docs/echarts-in-chat-donut.png
|
||||
- https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/6825178e277604594cd0a9b8f2789208e40ba59b/docs/echarts-in-chat-bar-line.png
|
||||
- https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/6825178e277604594cd0a9b8f2789208e40ba59b/docs/echarts-in-chat-trend.png
|
||||
- https://raw.githubusercontent.com/Tommy00748/hermes-plugin-echarts-in-chat/6825178e277604594cd0a9b8f2789208e40ba59b/docs/echarts-in-chat-donut.png
|
||||
platforms: []
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
name: error-ledger
|
||||
repo: https://github.com/olric3015/hermes-plugins
|
||||
sha: a6cf419d391a6c3ea79fe0300ff16fcbaf8f7a02
|
||||
sha: d8031eacf95a014334e719afbf1eb9c0c28e57c1
|
||||
subdir: error-ledger
|
||||
description: "Local ledger of failed provider calls (rate limits, overloads, timeouts, context overflows): /errors shows how many attempts failed per model, provider or cause, how many Hermes could retry, and the most common HTTP status, for the last 24 hours, the latest session or everything recorded. Disclosure — writes failed-attempt metadata (ids, provider, model, HTTP status, Hermes's failure class, exception class name, timings; no error message, request or prompt text) to plugin-data/error-ledger/errors.jsonl, trimmed to 5,000 rows past 2 MB; no network"
|
||||
description: "Local ledger of failed provider calls (rate limits, overloads, timeouts, context overflows): /errors shows how many attempts failed per model, provider or cause, how many Hermes could retry, and the most common HTTP status, for the last 24 hours, any number of hours or days, the latest session or everything recorded; /errors recent lists the newest failures and how long ago each happened. Disclosure — writes failed-attempt metadata (ids, provider, model, HTTP status, Hermes's failure class, exception class name, timings; no error message, request or prompt text) to plugin-data/error-ledger/errors.jsonl, trimmed to 5,000 rows past 2 MB; no network"
|
||||
maintainer: olric3015
|
||||
tier: community
|
||||
category: tools
|
||||
requires_hermes: ">=0.21.5"
|
||||
docs_url: https://github.com/olric3015/hermes-plugins/tree/main/error-ledger
|
||||
version: "1.0.0"
|
||||
image: https://raw.githubusercontent.com/olric3015/hermes-plugins/a6cf419d391a6c3ea79fe0300ff16fcbaf8f7a02/docs/error-ledger-card.png
|
||||
version: "1.1.0"
|
||||
image: https://raw.githubusercontent.com/olric3015/hermes-plugins/d8031eacf95a014334e719afbf1eb9c0c28e57c1/docs/error-ledger-card.png
|
||||
platforms: []
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
|
||||
@@ -0,0 +1,75 @@
|
||||
# Hermes plugin-catalog entry for hermes-frihet v0.1.0.
|
||||
#
|
||||
# Catalog: NousResearch/hermes-agent/plugin-catalog/frihet.yaml
|
||||
# Per the catalog rules (plugin-catalog/README.md):
|
||||
# - The maintainer of the plugin repository (Frihet-io) is the only one
|
||||
# authorised to submit the entry.
|
||||
# - ``tier`` MUST be ``community`` — ``official`` in the catalog means
|
||||
# "maintained by NousResearch". We describe ourselves as the "Official
|
||||
# Hermes Agent integration for Frihet" in the description, not in the
|
||||
# catalog's tier label.
|
||||
# - The SHA must be a 40-character full commit hash of a tagged, audited
|
||||
# commit of Frihet-io/hermes-frihet. Update via a new PR whenever we
|
||||
# ship a meaningful change (rule 4 of the catalog admission policy).
|
||||
name: frihet
|
||||
repo: https://github.com/Frihet-io/hermes-frihet
|
||||
# Pinned SHA — Frihet-io/hermes-frihet @ v0.1.0
|
||||
# (fix(security): canonical Frihet externalSideEffects drives classification).
|
||||
#
|
||||
# This SHA supersedes ``f331208`` (the older doctor that read the OAuth
|
||||
# token cache), ``24a9612`` (first privacy fix), ``3c8325a`` (CI rename
|
||||
# + first default_enabled), AND ``b9a8067`` (slash-command + redact
|
||||
# per-line + first connector safety net). It pins:
|
||||
# * Hook dispatcher that passes the FULL tool name to the gate (no
|
||||
# more silent bypass of the approval gate).
|
||||
# * Doctor that derives auth evidence from ``ctx.call_mcp`` — the
|
||||
# plugin never reads ~/.hermes/mcp-tokens.
|
||||
# * Doctor that drops the list_invoices envelope from its output
|
||||
# (no invoice/customer data leaks through /frihet doctor).
|
||||
# * Setup that does NOT accept credentials as slash-command
|
||||
# arguments (no transcript leak).
|
||||
# * Slash-command rejection of unknown subcommands and unexpected
|
||||
# positional arguments — neither branch echoes user input back.
|
||||
# * redact() per-line masking: every Authorization: line is masked
|
||||
# independently, including mislabelled secrets (token=, secret:,
|
||||
# api_key:, password=).
|
||||
# * tools.default_enabled reduced to 39 read-only operations —
|
||||
# every create_* was removed because the canonical Frihet MCP
|
||||
# contract declares them under externalSideEffects (webhooks or
|
||||
# fiscal). Users opt in to mutating ops via 'hermes mcp configure
|
||||
# frihet'.
|
||||
# * Plugin classifier reads vendor/frihet-mcp-onboarding.json —
|
||||
# a frozen copy of Frihet-io/frihet-mcp/docs/agent-onboarding.json
|
||||
# — and treats the humanAuthority.externalSideEffects table as
|
||||
# the source of truth. Local pattern lists stay as a fallback
|
||||
# for tools the contract has not yet named.
|
||||
# * CI renamed to manifest-validate (schema-only) plus a manual
|
||||
# live-hermes-validate (workflow_dispatch) for maintainers.
|
||||
#
|
||||
# Tests: 84 pass + 3 pre-existing skips. hermes plugins validate
|
||||
# --install-deps 15/15 with security scan "safe".
|
||||
sha: b77f5df4b269ada5296ee07fc9c03d118933cbc0
|
||||
description: "Official Hermes Agent integration for Frihet — discoverability, setup, diagnostics, and operating guidance for the Frihet MCP. Zero duplicated tools; the canonical 158-operation Frihet surface stays in @frihet/mcp-server and the remote endpoint https://mcp.frihet.io/mcp. Disclosure — /frihet setup and /frihet doctor send an unauthenticated MCP initialize to mcp.frihet.io (or FRIHET_MCP_URL); /frihet doctor also makes one read-only list_invoices call through Hermes's MCP client once you grant plugins.entries.frihet.mcp_allowlist; reads ~/.hermes/config.yaml only to check that an mcp_servers.frihet block exists; the pre_tool_call hook prompts before Frihet MCP calls it classifies as irreversible or unknown, but reads and draft-first creates pass without a prompt unless the server sets trust: untrusted."
|
||||
maintainer: Frihet-io
|
||||
tier: community
|
||||
category: tools
|
||||
docs_url: https://github.com/Frihet-io/hermes-frihet#readme
|
||||
requires_hermes: ">=0.21.5"
|
||||
version: "0.1.0"
|
||||
# Capabilities mirror plugin.yaml exactly.
|
||||
# Provides zero Python tools on purpose: the canonical Frihet surface
|
||||
# (158 operations) lives in @frihet/mcp-server and is reached via the
|
||||
# native Hermes MCP client. The plugin adds:
|
||||
# - a skill (skills/frihet/SKILL.md) that encodes the operating contract
|
||||
# - a pre_tool_call hook that escalates irreversible Frihet operations
|
||||
# to the human approval gate
|
||||
# - a /frihet slash command for setup/status/doctor
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks:
|
||||
- pre_tool_call
|
||||
provides_middleware: []
|
||||
# No env vars required. Credentials (Bearer API key or OAuth 2.0+PKCE)
|
||||
# live on the ``mcp_servers.frihet`` block in the user's config.yaml,
|
||||
# not on the plugin itself.
|
||||
requires_env: []
|
||||
@@ -0,0 +1,18 @@
|
||||
name: govee
|
||||
repo: https://github.com/promptclickrun/hermes-govee
|
||||
sha: 2d552cd1c67421cd5c9bbd8dd9b267f6dd5f0a0a
|
||||
description: "Discover and control Govee lights (power, brightness, color, white temperature, scenes) through Govee's developer API. Every command is checked against the model's advertised capabilities and ranges, then confirmed by a state read-back. Disclosure — sends device IDs and control commands to openapi.api.govee.com with your Govee API key; the model can change light state; stores nothing on disk."
|
||||
maintainer: promptclickrun
|
||||
tier: community
|
||||
category: tools
|
||||
version: "0.1.0"
|
||||
requires_hermes: ">=0.21.2"
|
||||
docs_url: https://github.com/promptclickrun/hermes-govee#readme
|
||||
platforms: []
|
||||
capabilities:
|
||||
provides_tools:
|
||||
- govee_lights
|
||||
provides_hooks: []
|
||||
provides_middleware: []
|
||||
requires_env:
|
||||
- GOVEE_API_KEY
|
||||
@@ -0,0 +1,25 @@
|
||||
name: hermes-kame-api-rotation
|
||||
repo: https://github.com/Kame696/kame-api-rotation-for-hermes
|
||||
sha: cab5372d18d233da905c9f84a343359d2bc26564
|
||||
subdir: hermes-kame-api-rotation
|
||||
description: "Smart API key rotation: the healthiest key for every call, each 429 / RESOURCE_EXHAUSTED / quota refusal sized from its own evidence. Install with its companion hermes-kame-provider, which hands Hermes this plugin's rotating client through ProviderProfile.create_client (and create_messages_client where Hermes offers it); no core override. Disclosure — /kame-keys add|import|split, and on start a key variable holding several comma-joined keys, write one auth.json pool row per key through Hermes' pool API after a plaintext backup (last 5 kept; switch: resolver_disabled); key-redacted, size-capped owner-only local logs and a status file per profile; the Desktop panel reads that file and queues its settings requests through its own dashboard/plugin_api.py route (GET /state, POST /control, this plugin's plugin-data folder only); while every key is resting, chats (CLI, Desktop, messaging gateway) keep waiting with no total limit (each key's rest capped by max_hold_seconds) and cron runs give up after 300 s with the provider's refusal unless max_total_wait_seconds is set."
|
||||
maintainer: Kame696
|
||||
tier: community
|
||||
category: models
|
||||
requires_hermes: ">=0.21.4"
|
||||
version: "1.8.2.2"
|
||||
docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.2#readme
|
||||
image: https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/cab5372d18d233da905c9f84a343359d2bc26564/assets/kame-banner.png
|
||||
screenshots:
|
||||
- https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/cab5372d18d233da905c9f84a343359d2bc26564/assets/panel-overview.png
|
||||
- https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/cab5372d18d233da905c9f84a343359d2bc26564/assets/panel-events.png
|
||||
- https://raw.githubusercontent.com/Kame696/kame-api-rotation-for-hermes/cab5372d18d233da905c9f84a343359d2bc26564/assets/panel-settings.png
|
||||
readme: true
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks:
|
||||
- transform_api_error_classification
|
||||
- post_api_request
|
||||
- on_session_reset
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
@@ -0,0 +1,17 @@
|
||||
name: hermes-kame-provider
|
||||
repo: https://github.com/Kame696/kame-api-rotation-for-hermes
|
||||
sha: cab5372d18d233da905c9f84a343359d2bc26564
|
||||
subdir: hermes-kame-provider
|
||||
description: "Companion to hermes-kame-api-rotation (install both). A model-provider plugin that re-registers Hermes' bundled API-key profiles unchanged except for create_client and create_messages_client, which return the rotation plugin's key-rotating client; otherwise None and Hermes builds its own. Same endpoints as Hermes, no third-party service, no core override."
|
||||
maintainer: Kame696
|
||||
tier: community
|
||||
category: models
|
||||
requires_hermes: ">=0.21.4"
|
||||
version: "1.8.2.2"
|
||||
docs_url: https://github.com/Kame696/kame-api-rotation-for-hermes/tree/v1.8.2.2/hermes-kame-provider#readme
|
||||
readme: true
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks: []
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
@@ -0,0 +1,15 @@
|
||||
name: hermes-plex-music
|
||||
repo: https://github.com/imzacksong/hermes-plex-music
|
||||
sha: c583d6fdaac61d2108bada99b275460b4d08a993
|
||||
description: "Mini-Plexamp for Hermes Desktop: statusbar player for your Plex music library — likes synced to Liked Songs, custom playlists with rename/delete, shuffle + repeat, sleep timer, queue editing, OS media keys. Needs only Plex Media Server. Zero API keys, zero model tokens. Disclosure — talks only to the Plex Media Server you configure (default http://127.0.0.1:32400), sending your Plex token in the request URL as Plex requires; the token is stored in Desktop plugin storage, and the optional \"Get token…\" button reads the Plex `.LocalAdminToken` file you pick. Likes and playlist create/rename/delete write to your Plex server. No agent tools, no telemetry."
|
||||
maintainer: imzacksong
|
||||
tier: community
|
||||
category: desktop
|
||||
requires_hermes: '>=0.21'
|
||||
docs_url: https://github.com/imzacksong/hermes-plex-music
|
||||
platforms: [windows]
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks: []
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
@@ -1,17 +0,0 @@
|
||||
name: hermes-review-loop
|
||||
repo: https://github.com/coe0718/hermes-review-loop
|
||||
sha: 431e7853c9ea99f22c81c8ec060b23d027b4e3bc
|
||||
description: "Unattended GitHub pull-request review between two Hermes agents: one pushes fixes, a different one reviews, rounds are capped in verdicts, a watchdog reports silent stalls, and the loop never merges. Disclosure — runs unattended Hermes agent turns inside bubblewrap (terminal and file tools, no network, no credentials); a host-side broker and the CLI write to GitHub (reviews, comments, labels, issues, repo webhooks, opt-in fixer pushes) with repo-scope PAT files you provide; edits Hermes's webhook_subscriptions.json directly and its watchdog re-adds this loop's routes while armed; writes gate scripts into the seat profiles' scripts/ folders and creates one hermes cron job; downloads PR archives from codeload.github.com and Rust crates from crates.io on the host; deletes its own state and closed-PR review dirs in roots you configure; on OAuth seats its host proxy may force Hermes token refreshes that rewrite ~/.claude, ~/.codex, ~/.qwen and profile auth.json credentials, and on Claude subscription logins it identifies as Claude Code (Claude Code user-agent, x-app and OAuth beta headers). Nothing runs until you arm a loop. Linux only."
|
||||
maintainer: coe0718
|
||||
tier: community
|
||||
category: automation
|
||||
requires_hermes: ">=0.21.5"
|
||||
docs_url: https://github.com/coe0718/hermes-review-loop#readme
|
||||
version: "0.1.1"
|
||||
platforms:
|
||||
- linux
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks: []
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
@@ -2,11 +2,15 @@ name: hermes-tenuo
|
||||
repo: https://github.com/tenuo-ai/hermes-tenuo
|
||||
sha: 8bce830c5df9dcd06d16688a954146d8edc0c562
|
||||
description: >-
|
||||
Per-call authorization for Hermes Agent tool calls.
|
||||
Each call is checked against a signed, expiring warrant before the
|
||||
handler runs, including argument constraints.
|
||||
Security guardrails for Hermes tool calls: per-call authorization, so a
|
||||
prompt injection cannot make the agent do more than you allowed. Each call
|
||||
is checked against a signed, expiring permission slip (a warrant) before
|
||||
the handler runs, down to the arguments (file paths, search queries,
|
||||
spending limits), and every decision lands in a local audit log. Give cron
|
||||
jobs, delegate_task subagents and gateway users their own policy.
|
||||
|
||||
Disclosure — hermes-tenuo is a no-op until a warrant is configured and blocks every tool call in a kanban worker that has no per-task warrant; it appends every tool call's name and full arguments to $HERMES_HOME/tenuo/audit.jsonl (disable with audit_log: false); when TENUO_CONNECT_TOKEN or TENUO_CONTROL_PLANE_URL are set, the bundled tenuo SDK (compiled Rust core) streams those decisions, including arguments, to that control plane.
|
||||
title: Tenuo
|
||||
maintainer: tenuo-ai
|
||||
tier: community
|
||||
category: tools
|
||||
|
||||
@@ -0,0 +1,29 @@
|
||||
name: hyatlas
|
||||
repo: https://github.com/tuancookiez-hub/HyAtlas-Memory
|
||||
sha: f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f
|
||||
subdir: plugins/hyatlas
|
||||
version: "4.3.2"
|
||||
image: https://raw.githubusercontent.com/tuancookiez-hub/HyAtlas-Memory/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/docs/images/banner.png
|
||||
screenshots:
|
||||
- https://raw.githubusercontent.com/tuancookiez-hub/HyAtlas-Memory/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/docs/images/desktop-overview.png
|
||||
- https://raw.githubusercontent.com/tuancookiez-hub/HyAtlas-Memory/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/docs/images/desktop-graph.png
|
||||
title: HyAtlas Memory
|
||||
description: "HyAtlas v4 — self-hosted 7-layer memory provider backed by a pure-Go single-binary server you run yourself (chromem-go vectors, in-process BGE-small embeddings, bitemporal knowledge graph with source citations). Embeddings, the vector index and stored memories stay local. Ships agent tools (hyatlas_status/search/recent/add), a `hermes hyatlas` CLI, a Desktop pane with a starmap graph view, and a web dashboard. Disclosure — requires the separate hyatlas-go server, installed by the user. The plugin never downloads or bundles it, and it talks only to the configured server (default 127.0.0.1:19528). Embeddings and stored memories stay local. Extraction is opt-in: the server has no default LLM endpoint and makes no LLM call until HYATLAS_LLM_BASE, HYATLAS_LLM_MODEL and HYATLAS_LLM_KEY are all set. The repo installer pre-fills a free Nous Portal endpoint that Enter accepts, but nothing is sent until you also enter a key. Once configured, each turn, including that turn's tool output, goes to that endpoint. In the default ultra mode the server also sends batches of up to 200 stored facts to it every 6 hours and deletes the facts the model marks merged or stale. HYATLAS_MODE=lite makes no LLM call. The spawned server gets an allowlisted environment (OS essentials plus HYATLAS_*), not the agent's keys. auto_start is off by default. On Windows, if a hyatlas-go.ps1 launcher is configured or sits beside the binary, `hermes hyatlas start/stop` runs it; the repo's sample launcher reads your Nous token from Hermes auth.json and points extraction at the Nous Portal. No telemetry."
|
||||
maintainer: tuancookiez-hub
|
||||
tier: community
|
||||
category: memory
|
||||
requires_hermes: ">=0.21.4"
|
||||
docs_url: https://github.com/tuancookiez-hub/HyAtlas-Memory/tree/f92bfe0f461c1dda0c80e3d0a0edb9266902ac9f/plugins/hyatlas
|
||||
platforms:
|
||||
- linux
|
||||
- macos
|
||||
- windows
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks: []
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
known_issues:
|
||||
- "After enabling, select the provider with `hermes memory setup` (memory.provider: hyatlas) — installing and enabling alone does not activate memory."
|
||||
- "The agent tools and hooks arrive through the MemoryProvider interface, not ctx.register_tool, so they do not appear in the plugin tool list."
|
||||
- "Requires the separate hyatlas-go server binary (installed by the user); without a reachable server the provider reports unavailable and memory features degrade rather than fail."
|
||||
@@ -1,7 +1,7 @@
|
||||
name: jot
|
||||
repo: https://github.com/Totoro-qaq/hermes-jot
|
||||
sha: '9e6f31616410a7282d18b6918b4b75a8672e0820'
|
||||
description: Notes, checklists and documents beside Hermes that your agent can read and update safely, with revision checks and one-click undo.
|
||||
sha: '4f80c96ddba74b46a3eadc9933258ec179f69eae'
|
||||
description: Notes, checklists and documents beside Hermes that your agent can read and update safely, with revision checks and undo for AI edits.
|
||||
maintainer: Totoro-qaq
|
||||
tier: community
|
||||
category: desktop
|
||||
@@ -9,10 +9,10 @@ requires_hermes: '>=0.21.5'
|
||||
version: '0.2.0'
|
||||
title: 'Jot'
|
||||
readme: true
|
||||
image: https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/9e6f31616410a7282d18b6918b4b75a8672e0820/assets/readme/banner.png
|
||||
image: https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/4f80c96ddba74b46a3eadc9933258ec179f69eae/assets/readme/banner.png
|
||||
screenshots:
|
||||
- https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/9e6f31616410a7282d18b6918b4b75a8672e0820/assets/readme/workspace.en.jpg
|
||||
- https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/9e6f31616410a7282d18b6918b4b75a8672e0820/assets/readme/sidebar.en.jpg
|
||||
- https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/4f80c96ddba74b46a3eadc9933258ec179f69eae/assets/readme/workspace.en.jpg
|
||||
- https://raw.githubusercontent.com/Totoro-qaq/hermes-jot/4f80c96ddba74b46a3eadc9933258ec179f69eae/assets/readme/sidebar.en.jpg
|
||||
known_issues:
|
||||
- Requires a current Hermes Desktop build with SandboxedFrame and gateway file-download SDK support.
|
||||
- Word attachments use download or the default application; the tested host does not render DOCX.
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
name: limbic
|
||||
repo: https://github.com/dyiapanis/limbic
|
||||
sha: 2aa69d02e1c0faa34e10b2a472647d4d10286e6f
|
||||
description: "Self-organising memory provider (MemoryProvider ABC): local SQLite (WAL) with sqlite-vec KNN + FTS5 hybrid recall, adaptive trust scoring, activation maturation, interference-based forgetting, NLI-based correction detection and synaptic atrophy. No LLM cost — all lifecycle mechanisms are deterministic. Tools (remember/recall) and lifecycle hooks dispatch via the MemoryManager from the registered provider — this entry registers a MemoryProvider only, so provides_tools/provides_hooks are empty. Disclosure — on first use downloads ~2.5GB of ONNX models (Arctic Embed 2.0 L, MiniLMv2 NLI) from huggingface.co at pinned commits with hash checks into ~/.cache/limbic/ (outside HERMES_HOME); spaCy NER models are not downloaded and must be installed manually for entity extraction; memory stays local in limbic.db under HERMES_HOME, and hermes backup adds VACUUM snapshots under HERMES_HOME/backups; no telemetry. PolyForm Noncommercial 1.0.0 (commercial use requires a separate license)."
|
||||
sha: d181a6372646afcfc89616e28b44db8d029a2ce9
|
||||
description: "Self-organising memory provider (MemoryProvider ABC): local SQLite (WAL) with sqlite-vec KNN + FTS5 hybrid recall, adaptive trust scoring, activation maturation, interference-based forgetting, NLI-based correction detection and synaptic atrophy. No LLM cost — all lifecycle mechanisms are deterministic. Tools (remember/recall) and lifecycle hooks dispatch via the MemoryManager from the registered provider — this entry registers a MemoryProvider only, so provides_tools/provides_hooks are empty. Disclosure — on first use downloads ~1.0GB of ONNX models (Arctic Embed 2.0 L int8 embedding, ~570MB; MiniLMv2 NLI, ~430MB) from huggingface.co at pinned commits with hash checks into ~/.cache/limbic/ (outside HERMES_HOME; an older fp32 cache of ~2.2GB is left in place); spaCy NER models are not downloaded and must be installed manually for entity extraction; memory stays local in limbic.db under HERMES_HOME, and hermes backup adds VACUUM snapshots under HERMES_HOME/backups; no telemetry. Stores created or reindexed on 0.6.0+ record the embedder that produced their vectors and report stale_embedder=true after an embedder change until `hermes limbic reindex`; stores from 0.5.x keep serving their fp32 vectors unflagged until reindexed. PolyForm Noncommercial 1.0.0 (commercial use requires a separate license)."
|
||||
maintainer: dyiapanis
|
||||
tier: community
|
||||
category: memory
|
||||
requires_hermes: ">=0.21.4"
|
||||
docs_url: https://github.com/dyiapanis/limbic#readme
|
||||
version: "0.5.1"
|
||||
version: "0.6.0"
|
||||
image: https://raw.githubusercontent.com/dyiapanis/limbic/01c04e2404b40b2c007899b8a415c67235d225d9/assets/banner.png
|
||||
readme: true
|
||||
platforms: []
|
||||
|
||||
@@ -0,0 +1,21 @@
|
||||
name: public-holidays
|
||||
repo: https://github.com/Akloenx123/hermes-public-holidays
|
||||
sha: d73f177b13c368c5c2445f6595f4008ed6c79a78
|
||||
description: "Public holidays for 200+ countries and their regions, plus workday checks, workday counts and deadline math (N working days after a date), computed in code instead of by the model. Disclosure — sends HTTPS GET requests to date.nager.at (Nager.Date, free, no key) carrying only a country code and a year; no redirects, 10 s timeout, responses cached in memory only. No credentials, no files written, no shell commands, no hooks, no background processes, no telemetry."
|
||||
maintainer: Akloenx123
|
||||
tier: community
|
||||
category: tools
|
||||
requires_hermes: ">=0.21.5"
|
||||
docs_url: https://github.com/Akloenx123/hermes-public-holidays#readme
|
||||
version: "0.1.0"
|
||||
readme: true
|
||||
platforms: []
|
||||
capabilities:
|
||||
provides_tools:
|
||||
- holidays_list
|
||||
- workday_check
|
||||
- workdays_count
|
||||
- workdays_add
|
||||
provides_hooks: []
|
||||
provides_middleware: []
|
||||
requires_env: []
|
||||
@@ -1,15 +1,16 @@
|
||||
name: quotum
|
||||
repo: https://github.com/qvotvm/hermes-quotum
|
||||
sha: ac1642dc8c6a712e2fc306b7df8b17be7690d2b3
|
||||
description: "A quotum seat's Venice key as a provider. Private and anonymized models, with the seat's daily cap, spend and the 20:00 UTC bell in /usage. Disclosure — prompts and QUOTUM_SEAT_KEY go to api.venice.ai; /usage and Desktop usage send a 16-hex sha256 handle of the key to quotum.org; QUOTUM_X_SEARCH=1 swaps in its own client that drops Hermes web_search for Venice-side web and X search (billed per search); seats are funded by the QUOTUM crypto token"
|
||||
sha: b27d42ea995567a66e64b2389b14a665c5a17611
|
||||
description: "A quotum seat's Venice key as a provider. Private and anonymized models, with the seat's daily cap, spend and the 20:00 UTC bell in /usage, and a Seals tab in hermes dashboard with the seat's record. Disclosure — prompts and QUOTUM_SEAT_KEY go to api.venice.ai; /usage, Desktop usage and the Seals tab send a 16-hex sha256 handle of the key to quotum.org, then the Seals tab reads the seat's public record from quotum.org (the key itself is never sent there); QUOTUM_X_SEARCH=1 swaps in its own client that drops Hermes web_search for Venice-side web and X search (billed per search); seats are funded by the QUOTUM crypto token"
|
||||
maintainer: quotum
|
||||
tier: community
|
||||
category: models
|
||||
version: "0.1.2"
|
||||
version: "0.2.0"
|
||||
requires_hermes: ">=0.21.5"
|
||||
docs_url: https://github.com/qvotvm/hermes-quotum#readme
|
||||
known_issues:
|
||||
- The optional QUOTUM_X_SEARCH mode supplies its own client through create_client, so it works with plugins.isolation in_process (the default) only; under host isolation leave it off.
|
||||
- Hermes' bundled Achievements page has no hook for outside achievements, so the seat's seals live in the plugin's own Seals tab.
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
provides_hooks: []
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
name: switchbot-control
|
||||
repo: https://github.com/TakeshiTGAL/hermes-plugin-switchbot-control
|
||||
sha: bb68cb4358b83ff01396a477834d766e9069aaff
|
||||
sha: eefc57ccec19ca1c47bfc746ba633d490a66dae4
|
||||
description: "SwitchBot OpenAPI v1.1, personal use. No Plug Mini on/off. Locks off unless enabled. setPosition only Curtain/Curtain3 (0=open). Disclosure — Controls real devices through the SwitchBot cloud API (api.switch-bot.com) using your SWITCHBOT_TOKEN and SWITCHBOT_SECRET. Every command asks for Hermes approval and is refused under cron, yolo, approvals off and unattended sessions. Lock and door devices stay refused unless you turn on safety_devices. The plugin has no user list of its own: anyone you allow on your Hermes gateway can request a command and approve it. Answering \"always\" adds an unused line to config.yaml each time. The optional watch is a cron job (a model turn every 5 minutes by default) that stays after uninstall until you run unschedule. Not tested on real devices."
|
||||
maintainer: TakeshiTGAL
|
||||
tier: community
|
||||
|
||||
@@ -1,18 +1,18 @@
|
||||
name: vault-view
|
||||
repo: https://github.com/ergocogn/hermes-desktop-plugin-vault-view
|
||||
sha: 532c9b95f204cafb224e33c8075c4a774ad6f7eb
|
||||
version: "0.4.8"
|
||||
sha: 7cc1d6f67205ece2b57c17500a198e3841215ac2
|
||||
version: "0.5.0"
|
||||
title: Vault View
|
||||
description: "Local Markdown vault workspace for Hermes Desktop: visual editing, progressive reading, cached image previews, shared tabs, tag search, links, backlinks and a graph. Compatible with Obsidian vaults. File transport requires a Linux/macOS gateway; Windows Desktop requires a WSL-hosted Unix backend, not a native Windows gateway; ffmpeg thumbnails are optional. Remote images and agent guidance are opt-in and disabled by default; automatic note-content sharing is disabled; direct Obsidian opening is temporarily hidden. Disclosure — reads and writes notes in the vault folder you choose through Desktop shell commands on the gateway host; remote Markdown images and agent navigation guidance stay off until you opt in."
|
||||
description: "Local Markdown vault workspace for Hermes Desktop: visual editing, progressive reading, cached image previews, optional per-conversation workspaces, pinned tabs, explicit selection quoting, tag search, links, backlinks and a graph. Compatible with Obsidian vaults. File transport requires a Linux/macOS gateway; Windows Desktop requires a WSL-hosted Unix backend, not a native Windows gateway; ffmpeg thumbnails are optional. Remote images and agent guidance are independent opt-ins and disabled by default; automatic note-content sharing is disabled; direct Obsidian opening is temporarily hidden. Disclosure — reads and writes notes in the vault folder you choose through Desktop shell commands on the gateway host; remote Markdown images and agent navigation guidance stay off until you opt in."
|
||||
maintainer: ergocogn
|
||||
tier: community
|
||||
category: desktop
|
||||
docs_url: https://github.com/ergocogn/hermes-desktop-plugin-vault-view#readme
|
||||
readme: true
|
||||
image: https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/532c9b95f204cafb224e33c8075c4a774ad6f7eb/assets/banner.png
|
||||
image: https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/7cc1d6f67205ece2b57c17500a198e3841215ac2/assets/banner.png
|
||||
screenshots:
|
||||
- https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/532c9b95f204cafb224e33c8075c4a774ad6f7eb/screenshots/vault-view-light.png
|
||||
- https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/532c9b95f204cafb224e33c8075c4a774ad6f7eb/screenshots/vault-view-settings.png
|
||||
- https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/7cc1d6f67205ece2b57c17500a198e3841215ac2/screenshots/vault-view-light.png
|
||||
- https://raw.githubusercontent.com/ergocogn/hermes-desktop-plugin-vault-view/7cc1d6f67205ece2b57c17500a198e3841215ac2/screenshots/vault-view-settings.png
|
||||
platforms: [linux, macos]
|
||||
capabilities:
|
||||
provides_tools: []
|
||||
|
||||
@@ -159,7 +159,8 @@ function releaseEpoch(tag, gitRoot) {
|
||||
return Number(supplied)
|
||||
}
|
||||
const claim = process.env.RELEASE_CLAIM_TAG
|
||||
if (claim && claim !== `${tag}-rc`) throw new Error('Stable claim tag differs from its payload tag')
|
||||
// Attempt refs read `rc.<N>-vX.Y.Z` (scripts/releases/versioning.py::parse_attempt_ref).
|
||||
if (claim && !new RegExp(`^rc\\.[1-9]\\d*-${tag.replaceAll('.', '\\.')}$`).test(claim)) throw new Error('Stable claim tag differs from its payload tag')
|
||||
const claimObject = process.env.RELEASE_CLAIM_OBJECT
|
||||
let timestamp
|
||||
let timestampTag = tag
|
||||
|
||||
@@ -247,6 +247,19 @@ def test_release_gates_extract_consumer_facing_versions():
|
||||
)
|
||||
assert '"$package/bin/hermes" --version' in nix_check
|
||||
assert "actual != expected" in nix_check
|
||||
# A path: flake has no git metadata; without ?rev= the stamp has no commit
|
||||
# and the packaged CLI reports "unknown".
|
||||
assert 'release-source?rev=$GITHUB_SHA' in nix_check
|
||||
flake_check = next(step["run"] for step in nix["flake-check"]["steps"] if step.get("name") == "nix flake check")
|
||||
assert "release-source?rev={1}" in flake_check and "github.sha" in flake_check
|
||||
|
||||
|
||||
def test_versioned_docker_images_belong_to_one_attempt():
|
||||
# The final vX.Y.Z does not exist until publish; a second attempt pushing
|
||||
# under it collides with the first attempt's immutable manifest list.
|
||||
jobs = workflow("stable-release.yml")["jobs"]
|
||||
for name in ("docker", "publish-docker"):
|
||||
assert jobs[name]["with"]["tag"] == "${{ needs.admit.outputs.claim-tag }}"
|
||||
|
||||
|
||||
def test_packaged_stamp_writers_receive_versions_without_rewriting_python_metadata():
|
||||
|
||||
@@ -22,6 +22,17 @@ def _write_plugin(root, rel, name, extra=""):
|
||||
return d
|
||||
|
||||
|
||||
def _write_tool_plugin(root, name):
|
||||
"""User plugin registering one tool in its own toolset, WITHOUT ``provides_tools`` in plugin.yaml."""
|
||||
d = _write_plugin(root, name, name)
|
||||
(d / "__init__.py").write_text(
|
||||
"def register(ctx):\n"
|
||||
f" ctx.register_tool(name='{name}_tool', toolset='{name}_ts', handler=lambda args, **kw: '{{}}',\n"
|
||||
f" schema={{'name': '{name}_tool', 'description': 'probe', 'parameters': {{'type': 'object', 'properties': {{}}}}}})\n",
|
||||
encoding="utf-8")
|
||||
return d
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def home(tmp_path, monkeypatch):
|
||||
hermes_home = tmp_path / "hermes-home"
|
||||
@@ -85,6 +96,23 @@ def test_dashboard_toggle_writes_canonical_key_and_clears_stale_aliases(home):
|
||||
assert again["unchanged"] is True and again["restart_required"] is False
|
||||
|
||||
|
||||
def test_dashboard_enable_on_a_fresh_config_keeps_the_core_tools(home):
|
||||
"""Desktop/TUI/dashboard enable with no saved ``platform_toolsets`` must not write one: the old
|
||||
seed ``platform_toolsets.cli: [<plugin_ts>]`` replaced the ``hermes-cli`` composite, so the model
|
||||
lost every built-in tool (27 -> 2, no ``terminal``). The plugin toolset is on by default anyway."""
|
||||
from hermes_cli.tools_config import _get_platform_tools
|
||||
from tools.registry import registry
|
||||
|
||||
_write_tool_plugin(home / "plugins", "zzseed")
|
||||
try:
|
||||
assert plugins_cmd.dashboard_set_agent_plugin_enabled("zzseed", enabled=True)["ok"] is True
|
||||
cfg = load_config()
|
||||
assert not cfg.get("platform_toolsets")
|
||||
assert {"terminal", "file", "zzseed_ts"} <= _get_platform_tools(cfg, "cli")
|
||||
finally:
|
||||
registry.deregister("zzseed_tool")
|
||||
|
||||
|
||||
def test_status_reports_bundled_defaults_and_the_live_memory_provider(home):
|
||||
"""Bundled backends (auto-load) and the plugin selected by ``memory.provider`` run without a
|
||||
``plugins.enabled`` entry; status must not call them "not enabled" (#73131, #82898)."""
|
||||
|
||||
@@ -55,6 +55,31 @@ def test_remove_forgets_every_config_trace_and_resets_the_memory_provider(home):
|
||||
assert not cfg["memory"]["provider"]
|
||||
|
||||
|
||||
def test_remove_clears_the_toolset_of_a_plugin_without_provides_tools(home):
|
||||
"""``remove`` drops the plugin's toolset from a saved ``platform_toolsets`` list even when
|
||||
plugin.yaml never declared ``provides_tools``; otherwise ``hermes config check`` warns about an
|
||||
unknown toolset forever."""
|
||||
from tools.registry import registry
|
||||
|
||||
d = _write_plugin(home / "plugins", "zznodecl", "zznodecl")
|
||||
(d / "__init__.py").write_text(
|
||||
"def register(ctx):\n"
|
||||
" ctx.register_tool(name='zznodecl_tool', toolset='zznodecl_ts', handler=lambda args, **kw: '{}',\n"
|
||||
" schema={'name': 'zznodecl_tool', 'description': 'probe',\n"
|
||||
" 'parameters': {'type': 'object', 'properties': {}}})\n",
|
||||
encoding="utf-8")
|
||||
(home / "config.yaml").write_text(yaml.safe_dump({
|
||||
"plugins": {"enabled": ["zznodecl"]},
|
||||
"platform_toolsets": {"cli": ["hermes-cli", "zznodecl_ts"], "telegram": ["hermes-telegram"]},
|
||||
}), encoding="utf-8")
|
||||
try:
|
||||
assert plugins_cmd.dashboard_remove_user_plugin("zznodecl")["ok"] is True
|
||||
finally:
|
||||
registry.deregister("zznodecl_tool")
|
||||
|
||||
assert _config(home)["platform_toolsets"] == {"cli": ["hermes-cli"], "telegram": ["hermes-telegram"]}
|
||||
|
||||
|
||||
def test_remove_of_a_symlink_inside_the_plugins_dir_unlinks_only_the_link(home):
|
||||
"""A dev alias pointing at a sibling install resolves INSIDE the plugins dir, so the containment
|
||||
check passes; removing the alias must not delete the sibling (or its install metadata)."""
|
||||
|
||||
@@ -280,6 +280,13 @@ provides_hooks:
|
||||
|
||||
This tells Hermes: "I'm a plugin called calculator, I provide tools and hooks." The `provides_tools` and `provides_hooks` fields are lists of what the plugin registers.
|
||||
|
||||
List every tool your `register()` registers in `provides_tools`. The field does **not** decide whether a user-installed plugin's tools load: once the plugin is enabled, everything `register()` registers is available, declared or not. What it does drive:
|
||||
|
||||
- **`hermes plugins validate`**: the "declared tools" check fails when the registered tools don't match the list, which blocks catalog admission.
|
||||
- **Catalog listing**: the "N tools" chips and tool-name search in the catalog and the dashboard/Desktop Plugins page.
|
||||
- **Dashboard auth hint**: only declared tools' availability checks are used to show "needs auth" and the `hermes auth <name>` command.
|
||||
- **Bundled `kind: platform` plugins only**: the field is the switch that loads `tools.py` in CLI/TUI sessions while the adapter stays deferred. See [Outbound client tools](../adding-platform-adapters.md#outbound-client-tools-provides_tools).
|
||||
|
||||
Optional fields you could add:
|
||||
```yaml
|
||||
author: Your Name
|
||||
|
||||
+7
@@ -67,6 +67,13 @@ provides_hooks:
|
||||
|
||||
这告诉 Hermes:"我是一个名为 calculator 的插件,我提供工具和钩子。" `provides_tools` 和 `provides_hooks` 字段是插件注册内容的列表。
|
||||
|
||||
请在 `provides_tools` 中列出 `register()` 注册的每一个工具。该字段**不**决定用户安装的插件的工具是否加载:插件启用后,`register()` 注册的所有工具都可用,无论是否声明。它实际影响的是:
|
||||
|
||||
- **`hermes plugins validate`**:注册的工具与列表不一致时,“declared tools”检查失败,插件无法进入目录(catalog)。
|
||||
- **目录展示**:目录及仪表盘/桌面端插件页中的“N 个工具”标签和按工具名搜索。
|
||||
- **仪表盘认证提示**:只有已声明工具的可用性检查会用于显示“需要认证”及 `hermes auth <name>` 命令。
|
||||
- **仅限内置的 `kind: platform` 插件**:该字段决定是否在 CLI/TUI 会话中加载 `tools.py`(适配器本身仍延迟加载)。参见 [添加平台适配器](../adding-platform-adapters.md)。
|
||||
|
||||
可选字段示例:
|
||||
```yaml
|
||||
author: Your Name
|
||||
|
||||
Reference in New Issue
Block a user