hermes-market

Hermes Market

Discover owner-published APIs across sellers, create public service drafts from
selected skills, and buy results only after explicit human approval.

Agent tools

service_search: search the configured public service directory.
service_draft: use the host ctx.llm interface to draft a public contract.
service_inspect and service_quote: inspect a listing and request an exact quote.
service_purchase and service_status: submit a stored approval and recover the original result.

Install

Requires Hermes Agent 0.22.7 or newer. Tested with Hermes 0.23.0.

hermes plugins install snuff12/hermes-market
hermes plugins enable hermes-market

During catalog review, install from the repository above. Catalog installation
by the bare name becomes available only after a maintainer accepts the entry.
The catalog entry pins the exact reviewed source commit.

Public marketplace and local workspaces

Fresh installations default to buyer_mode: simulation. Both directory_origin
and buyer_origin are empty. Search and listing tools return a setup error until
you set directory_origin; new slug-based requests require buyer_origin.
No buyer or discovery request is sent before the required origin is configured.
Saved purchases continue to use their original seller, even if these settings
are cleared. Testnet purchases still require an explicit buyer_mode: testnet.

The backend source and step-by-step setup are in
hermes-market-server.
Start with its free simulation. Configure these settings in your active Hermes
profile, replacing the example state path with your actual private directory:

plugins:
  enabled: [hermes-market]
  entries:
    hermes-market:
      settings:
        role: buyer
        directory_origin: http://127.0.0.1:8795
        buyer_mode: simulation
        buyer_origin: http://127.0.0.1:8765
        buyer_state_dir: /absolute/path/to/hermes-market-server/.state/buyer

Ask Hermes to find services with service_search, inspect one, and prepare a
quote. Payment approval is a separate human action. For owner drafting, use
role: owner or both and configure the private draft_dir shared with the
owner workspace. See the server guide for Base Sepolia setup and browser approval.

Optional public demo

To opt in to the author-operated public demo, paste the following values into
the plugin's settings and replace both private paths with your actual gateway
paths:

directory_origin: https://market.0xeddie.kim
buyer_origin: https://market-api.0xeddie.kim
buyer_mode: testnet
buyer_state_dir: /absolute/path/to/hermes-market-server/.state/buyer-testnet
buyer_vault_key_file: /absolute/path/to/hermes-market-server/.state/buyer-testnet/authorization.key
buyer_approval_origin: http://127.0.0.1:8767

From the server checkout, start the separate local approval gateway with matching
origins and paths. Replace the example paths consistently in both places:

.venv/bin/hermes-market buyer-gateway \
  --origin https://market-api.0xeddie.kim \
  --directory-origin https://market.0xeddie.kim \
  --buyer-state /absolute/path/to/hermes-market-server/.state/buyer-testnet \
  --vault-key-file /absolute/path/to/hermes-market-server/.state/buyer-testnet/authorization.key

This sends search queries to the demo directory. Inspecting or quoting a selected
listing contacts its seller; quote input and the seller-scoped wallet session go
to that seller. Review the seller origin before requesting a quote. These demo
hosts are optional and depend on the author's computer staying online. Mainnet
is disabled; this demo uses Base Sepolia test USDC.

Seller, directory and buyer gateway processes are separately operated services;
installing this plugin does not start them or expose your computer. The optional
Desktop page opens the optional public demo only after you click its labeled button,
and opens local My services and Purchases workspaces
in your browser. It is a launcher, not an embedded wallet.

Disclosure

Network requests go to the explicitly configured directory and selected sellers.
Directory descriptions and results are untrusted data. The buyer keeps a local
SQLite ledger, encrypted seller sessions and signed payment authorizations in
its own configured state. A local browser gateway collects EOA wallet signatures;
the agent cannot approve or sign a payment. Shared budget reservations cover all
sellers. A purchase always recovers through its saved origin.

Owner mode reads explicitly selected SKILL.md files and static references, and
saves private draft bundles. The host LLM supplies inference; this package does
not read a provider credential store or include the developer token-copy helper.

The seller backend, its isolated model runtime, the service directory, the browser
wallet gateway, and public hosting are separate prerequisites. Current evidence
covers local simulation and Base Sepolia test USDC. Mainnet is unsupported.
There is no telemetry or self-updater. Source-only export; no compiled payloads.

Catalog status

Catalog admission requires a maintainer-reviewed, SHA-pinned PR. Local validation
does not establish catalog acceptance. Validate this exact source tree with:

hermes plugins validate /path/to/hermes-market --install-deps

License

MIT. See LICENSE.

README from the reviewed commit 3def9a2; it updates when the author re-pins.

About