https://github.com/rabilrbl/hermes-ollama-cloud-usage
Hermes Agent skill to check Ollama Cloud usage
https://github.com/rabilrbl/hermes-ollama-cloud-usage
hermes-agent hermes-agent-plugin ollama ollama-cloud
Last synced: 18 days ago
JSON representation
Hermes Agent skill to check Ollama Cloud usage
- Host: GitHub
- URL: https://github.com/rabilrbl/hermes-ollama-cloud-usage
- Owner: rabilrbl
- License: mit
- Created: 2026-05-06T10:52:07.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-27T11:15:15.000Z (about 2 months ago)
- Last Synced: 2026-06-14T22:03:14.627Z (about 1 month ago)
- Topics: hermes-agent, hermes-agent-plugin, ollama, ollama-cloud
- Language: Python
- Homepage: https://github.com/rabilrbl/hermes-ollama-cloud-usage
- Size: 20.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Hermes Skill: Ollama Cloud Usage
Check your Ollama Cloud Pro/Max subscription usage right inside Hermes Agent.
Since Ollama Cloud does not expose a public usage API (see [ollama/ollama#12532](https://github.com/ollama/ollama/issues/12532)), this skill scrapes your usage stats from `https://ollama.com/settings` using your authenticated session cookie.
## Install
```bash
hermes skills install rabilrbl/hermes-ollama-cloud-usage/ollama-cloud-usage
```
## Getting your cookie
1. Open a browser and log in to [https://ollama.com/settings](https://ollama.com/settings).
2. Open DevTools → **Application** (or **Storage** on Firefox) → **Cookies**.
3. Copy all cookies for `ollama.com` (e.g. `auth=xxx; other=yyy`).
4. Set it in your Hermes env config (located in your Hermes home directory, under the filename `.env`):
```bash
OLLAMA_CLOUD_COOKIE="auth=xxx; other=yyy"
```
Then restart Hermes or run `/reset` to reload.
## Usage
Ask Hermes about your Ollama Cloud usage:
```
Check my Ollama Cloud usage
```
The skill returns:
- **Plan tier** (Pro / Max)
- **Session usage** % and reset timer
- **Weekly usage** % and reset timer
- ASCII progress bars
## Example output
```json
{
"plan": "Pro",
"session_percent": 0.1,
"session_resets_in": "3 hours",
"weekly_percent": 13.3,
"weekly_resets_in": "4 days",
"session_bar": "█░░░░░░░░░░░░░░░░░░░",
"weekly_bar": "███░░░░░░░░░░░░░░░░░"
}
```
## Limitations
- Works for **Pro** and **Max** tiers shown on the Ollama Cloud settings page.
- Requires a valid browser session cookie. If the cookie expires, re-copy it and update your env config.
- Scrapes HTML, so the parser may need updates if Ollama changes the dashboard layout.
## License
MIT