David Frassi
44 lines
3.0 KiB
Markdown
44 lines
3.0 KiB
Markdown
# 📊 Guida alla Sincronizzazione Real-Time dei Crediti Higgsfield AI
|
|
|
|
Questa guida spiega come abilitare il tracciamento automatico e in tempo reale del consumo crediti del tuo abbonamento Higgsfield AI (Pro Plan) all'interno della dashboard Streamlit.
|
|
|
|
Seguendo le tue indicazioni di sicurezza, **il sistema non effettua scansioni del tuo browser Chrome né accede al portachiavi di sistema (Chrome Safe Storage)**. La sincronizzazione si basa unicamente sul token di sessione configurato nel file `.env`.
|
|
|
|
---
|
|
|
|
## 🛠️ Cosa è stato fatto
|
|
1. **Automazione Completa**: Rimosso il form manuale per regolare il budget dei crediti dal cruscotto Streamlit. Ora i crediti si allineano da soli online.
|
|
2. **Aggiornamento REST Real-Time**: Implementato un client REST ufficiale (`HiggsClient`) in `src/app.py` che, ad ogni avvio o refresh del cruscotto, interroga in tempo reale i server di Higgsfield per mostrare la percentuale e i crediti rimanenti effettivi.
|
|
3. **Indicatori Grafici Premium**:
|
|
* **🟢 SINCRONIZZATO ONLINE**: Indica che il token è valido e i crediti mostrati provengono in diretta dal tuo account, con data e ora dell'ultimo allineamento.
|
|
* **🟡 CONTATORE LOCALE (CACHE)**: Compare se il token non è impostato nel file `.env`, indicandoti come procedere.
|
|
* **🔴 ERRORE DI CONNESSIONE**: Compare in caso di token scaduto o problemi temporanei di connessione, mantenendo visibile l'ultima cache per stabilità.
|
|
|
|
---
|
|
|
|
## 🔑 Come configurare la sincronizzazione automatica
|
|
|
|
Per sbloccare il monitoraggio automatico dei crediti reali, devi aggiungere il tuo token di sessione all'interno del file di configurazione ambientale. Segui questi passi semplici:
|
|
|
|
1. Apri il browser ed effettua l'accesso sul sito ufficiale **[higgsfield.ai](https://higgsfield.ai)**.
|
|
2. Premi `F12` (oppure clicca col tasto destro sulla pagina e seleziona **Ispeziona**) per aprire gli Strumenti per Sviluppatori del browser.
|
|
3. Spostati nella scheda **Application** (su Google Chrome) o **Storage** (su Firefox/Safari).
|
|
4. Nel menu laterale sinistro, espandi la voce **Cookies** e seleziona `https://higgsfield.ai`.
|
|
5. Cerca nell'elenco la riga con il nome **`__session`**.
|
|
6. Fai doppio clic sul valore del cookie per selezionarlo interamente e **copialo** (è una lunga stringa alfanumerica che inizia con `eyJ...`).
|
|
7. Apri il file [**.env**](file:///Users/davidfrassi/SRC/agenti/agenzia/.env) situato nella cartella principale del progetto.
|
|
8. Aggiungi la seguente variabile in fondo al file incollando il token copiato:
|
|
```env
|
|
HIGGSFIELD_TOKEN=eyJ...[incolla_qui_il_tuo_token]
|
|
```
|
|
9. Salva il file `.env`.
|
|
|
|
---
|
|
|
|
## 🚀 Risultato Atteso
|
|
|
|
Una volta salvata la variabile nel file `.env`, ricarica il cruscotto Streamlit. Il pannello in basso dedicato ai crediti:
|
|
* Rileverà automaticamente il token.
|
|
* Mostrerà il badge verde **🟢 SINCRONIZZATO ONLINE** con la data e l'ora dell'aggiornamento.
|
|
* Mostrerà i tuoi reali crediti rimanenti online e la percentuale esatta consumata, in perfetto allineamento con la dashboard ufficiale di Higgsfield!
|