LLMUX

From its catalog listing

Compare Surplus Intelligence, Antseed and Solid offers in the Hermes composer, then route through one local provider by price, speed or balanced policy. Includes seller trust signals, explicit mid-chat switching, cached market data and a local usage ledger.

Good to know before installing

Loading the plugin starts a detached local proxy on 127.0.0.1:8378 (LLMUX_PORT) that keeps running after Hermes exits and holds this profile's Surplus/Solid API keys (set LLMUX_AUTOSTART=0 to run it yourself); every chat sent through the llmux provider is forwarded in full to the seller it picks on Surplus Intelligence (api.surplusintelligence.ai), Solid (accounts.solid.xyz) or your local Antseed buyer (127.0.0.1:8377), where third-party marketplace sellers may serve it and bill your account with no spending cap; it also polls those marketplaces for prices in the background and keeps a market cache and proxy log under your Hermes home.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs SURPLUS_API_KEY), then asks whether to turn it on.
    hermes plugins install llmux
  2. Said no? Turn it on later:
    hermes plugins enable llmux
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Cost, speed & monitoring · AI models & providers
Maintained by
ivcained (Community)
Needs
SURPLUS_API_KEY API key
Works on
linux, macos
Needs Hermes
0.22.6 or newer
Version
0.1.1
In the catalog
2026-11-11

Known issues (from its catalog listing)

  • Installed-Desktop mid-chat switching and a real paid reply/ledger row have not yet been verified. Automated card interactions use a simulated SDK host.
  • Inference is billable at the selected seller with no hard spending ceiling. Cross-source failover is off by default; LLMUX_ALLOW_FAILOVER=1 permits additional potentially billable attempts after upstream failures.
  • Marketplace keys resolve through agent.secret_scope.get_secret. Each proxy port is bound to one profile/configuration; mismatches fail closed. Antseed-only operation without any marketplace key is not supported. Solid prices are a dated manual table; speed and trust are unpublished.
  • Trusted view excludes explicit marketplace untrusted signals, but still includes sources with no published trust verdict. Lists are ranked shortlists, not every marketplace seller.
  • Starts a detached loopback proxy which can outlive Hermes. It reads configured marketplace credentials, sends inference context to the selected upstream and writes proxy logs, public market-cache snapshots and a local usage ledger. The ledger is off by default and enabled only with LLMUX_TRACK_USAGE=1.
  • Default upstreams are api.surplusintelligence.ai, accounts.solid.xyz and the optional Antseed buyer proxy at 127.0.0.1:8377. Base URLs are configurable.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in cost, speed & monitoring

All cost, speed & monitoring plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins