# Ollama Cloud Usage — plasmoide KDE Plasma 6

[![Gitea](https://img.shields.io/badge/Gitea-enne2%2Fkde--ollamacloud--dashboard-blue?logo=gitea)](https://git.enne2.net/enne2/kde-ollamacloud-dashboard)

Widget per KDE Plasma 6 che mostra il **residuo della sessione (5h)** e il
**residuo settimanale (7d)** di [Ollama Cloud](https://ollama.com), il provider
`ollama-cloud` configurato nel [pi agent](https://pi.dev).

Legge la chiave API da `~/.pi/agent/auth.json` (provider `ollama-cloud`, lo
stesso usato dall'estensione `pi-ollama-cloud`) e interroga l'endpoint
**non documentato** `GET https://ollama.com/api/usage`. L'API restituisce
`usage` come frazione 0..1 **già usata**, quindi il residuo è `1 - usage`.

## Funzionalità

- **Icona nel pannello** + due mini-barre verticali (5h / 7d) colorate in base
  al residuo: verde ≥ soglia gialla, giallo tra soglia rossa e gialla, rosso
  sotto la soglia rossa. Click = apre il popup.
- **Popup** con due barre grandi, percentuale residuo/usato, conteggio richieste
  per modello e costo attività delle ultime 4 settimane.
- **Countdown di reset** con data/ora prevista e tempo mancante (es. "1h 23m" /
  "6g 14h"). Stima iniziale su finestre 5h/7d, poi calibrato automaticamente
  quando il dashboard rileva una rigenerazione effettiva della quota.
  Etichetta "STIMA" finché non calibrato, "RILEVATO" dopo il primo reset
  osservato.
- **Aggiornamento automatico** ogni N secondi (default 300, come l'estensione
  pi) + pulsante di refresh manuale.
- **Configurabile**: intervallo di aggiornamento, soglie di colore, visibilità
  del costo attività e dei conteggi per modello.

## File

```
metadata.json                  metadata del pacchetto (Plasma/Applet)
contents/config/main.xml       schema della configurazione (kcfg)
contents/scripts/usage.sh       backend: legge la key, chiama /api/usage, stampa JSON
contents/ui/main.qml            UI (compact + full representation)
contents/ui/LimitRow.qml        riga di residuo riutilizzabile
contents/ui/configGeneral.qml  pagina di configurazione
```

## Installazione

```bash
# dal sorgente
kpackagetool6 --type Plasma/Applet --install /home/enne2/Dev/org.enne2.ollamacloud.usage

# aggiornamento dopo modifiche
kpackagetool6 --type Plasma/Applet --upgrade /home/enne2/Dev/org.enne2.ollamacloud.usage
```

Poi "Aggiungi widget" → cerca "Ollama Cloud Usage" e trascinalo nel pannello o
sul desktop.

## Dipendenze

- `jq` e `curl` (per lo script di backend)
- la chiave API di Ollama Cloud in `~/.pi/agent/auth.json` sotto
  `ollama-cloud` (oppure nella variabile `OLLAMA_API_KEY`)

## Note

- L'endpoint `/api/usage` è **non documentato** e potrebbe cambiare o sparire:
  lo script gestisce i casi 404/401/429/5xx restituendo un JSON di errore che il
  plasmoide mostra in modo leggibile.
- La chiave API non viene mai stampata né passata come argomento del processo.