# Nine-Balance Widget: Hermes Agent plugin

> Nine AI provider balances in one desktop widget — live balance/usage and quota reads, token-based spend estimates with off-peak price windows, drop alerts, and an anime mascot per provider with rotating flavour lines…

Canonical: https://hermeswatcher.com/plugins/nine-balance-widget  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/nine-balance-widget  
Last updated in catalog: 2026-10-12

Nine AI provider balances in one desktop widget — live balance/usage and quota reads, token-based spend estimates with off-peak price windows, drop alerts, and an anime mascot per provider with rotating flavour lines (DeepSeek, MiniMax, GLM, Kimi, MiMo, ChatGPT, Claude, Gemini, Grok). Fully English UI. Desktop-only: desktop/plugin.js inside the plugin SDK surface; no agent tools, hooks, middleware or env vars. Keys are entered in the widget's settings page and stored in plugin-scoped storage; the widget only calls those providers' official APIs. Ported from MeteorNOX/DeepSeek-Balance-Whale-Widget (MIT).

## Good to know before installing

API keys you enter in the widget's settings are stored in plaintext in Desktop plugin storage (not Hermes' secret store); while the widget is on, the Desktop renderer polls the balance/usage endpoint of the provider matching your current model every 60 s with that provider's key (api.deepseek.com, api.minimaxi.com / api.minimax.io, open.bigmodel.cn / api.z.ai, api.moonshot.cn / api.moonshot.ai, api.kimi.com, token-plan-cn.xiaomimimo.com, api.openai.com, api.anthropic.com, generativelanguage.googleapis.com with the key in the URL, api.x.ai); each key goes only to its own provider; draws a floating widget over the app window.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install nine-balance-widget
```

2. Said no? Turn it on later:

```bash
hermes plugins enable nine-balance-widget
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Cost, speed & monitoring, Hermes Desktop add-ons
- Maintained by: OMOX563 (Community)
- Needs: No API keys declared
- Requires Hermes: `>=0.21.5`
- Version: 1.0.0
- In the catalog since: 2026-10-12

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/nine-balance-widget)
- [Source code](https://github.com/OMOX563/nine-balance-widget)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt