Neuralwatt provider for Hermes

Run Hermes on Neuralwatt. You get the live model list, reasoning effort that works, and your balance and energy use in /usage.
Install
hermes plugins install ptaranat/hermes-neuralwatt-provider
Add your key from the Neuralwatt Portal to ~/.hermes/.env:
NEURALWATT_API_KEY=sk-...
Then pick Neuralwatt in hermes model. Or set it in ~/.hermes/config.yaml:
model:
provider: neuralwatt
default: nw-large
NEURALWATT_BASE_URL changes the API URL. The default is https://api.neuralwatt.com/v1.
Coming from Neuralwatt's recipe
Neuralwatt's Hermes recipe uses the same provider name and env vars. Your config keeps working. Remove the recipe first so both don't register neuralwatt:
rm -r ~/.hermes/plugins/model-providers/neuralwatt
What you get
- Models.
/modellists Neuralwatt's live catalog with real context windows. If the catalog is down, you still getnw-large,nw-flashandnw-small. Side tasks like compression usenw-flash. - Reasoning effort. Your Hermes reasoning setting is sent as
reasoning_effort. The recipe never sends it. Without it, requests run at the model's default (oftenmax). Turning reasoning off sendsnone. GLM 5.3 can't turn it off. It gets its lightest level instead. - Sessions. Each Hermes session is sent as a conversation id. The Neuralwatt dashboard then shows one session per conversation.
- Cost per turn. Energy-billed accounts get an energy estimate. It uses Neuralwatt's published average energy per request for that model and prompt size, at your $/kWh rate. Like Neuralwatt's own billing, it never goes above the token price. Turns covered by daily free energy or a plan's kWh allowance show as included. Token-billed accounts get an estimate from token prices. These are estimates.
/usagehas the exact spend. /usage. Credits left, this month's spend and energy, daily free energy, plan or key limits, and 30-day energy and carbon.
For Neuralwatt tools the agent can call (usage, requests, sessions), install 0xGingi's neuralwatt plugin too.
Privacy
- It only talks to Neuralwatt: the API, and the public energy price table at
portal.neuralwatt.com. - The conversation id is Hermes's session id. It has no prompt text. Neuralwatt stores a hash of it.
- Your key is read through Hermes's secret scope.
- It writes no files and starts no threads or processes.
Compatibility
Hermes 0.22.6 or newer.
Development
python -m unittest discover -s tests -v
The tests use saved API responses. They don't need a key or Hermes.
License
MIT. Not affiliated with Neuralwatt. The Neuralwatt name and logo belong to Neuralwatt.
README from the reviewed commit 2523343; it updates when the author re-pins.
ptaranat