Apppublic

domemoro-12-krea/zagreo-conto-termico

sourceHugging Faceupdated 10d agoView on Hugging Face

0likes

App README

Zagreo Master - White-Label AI Engine

🎯 Scopo del Progetto

Zagreo è un motore AI configurabile (White-Label) ottimizzato per applicazioni RAG (Retrieval-Augmented Generation) verticali su domini normativi e tecnici. Grazie a un'architettura Config-Driven, il motore può alimentare assistenti diversi (es. Conto Termico 3.0, Protezione Civile - Ciclone Harry) semplicemente cambiando un file di configurazione TOML.

🏗️ Architettura Ibrida & Config-Driven

Il sistema utilizza Hybrid Context Caching su Google Gemini (es. gemini-3.1-pro-preview):

1.Motore Agnostico: La logica di app.py è separata dai dati di dominio.
2.Configurazione TOML: Titoli, branding, istruzioni di sistema e parametri LLM sono definiti in file .toml.
3.Isolamento della Cache: Ogni dominio utilizza namespace isolati su Vertex/Gemini per prevenire collisioni di dati.
4.Ingestione Dinamica: I documenti vengono letti da cartelle specifiche configurate per ogni dominio.
5.Smart-OPEX: Gestione automatizzata del TTL e cleanup della cache per ottimizzare i costi operativi.

🚀 Quick Start

1.Clonare la repo ed attivare il venv (Python 3.12 — Streamlit 1.42.0 non parte su 3.14):

bash

    python3.12 -m venv .venv
    source .venv/bin/activate
    pip install -r requirements.txt

1.Configurare le credenziali: Inserire la GOOGLE_API_KEY in .streamlit/secrets.toml.

1.Scegliere il Dominio: Il sistema carica di default config_ct3.toml. Per cambiare dominio, imposta la variabile d'ambiente APP_CONFIG:

ZAGREO - Polizze Auto:

bash

    source .venv/bin/activate
    export APP_CONFIG=config_polizze.toml
    streamlit run app.py

Conto Termico 3.0 (Default):

bash

    export APP_CONFIG=config_ct3.toml
    streamlit run app.py

Harry Claim Master (Protezione Civile):

bash

    export APP_CONFIG=config_harry.toml
    streamlit run app.py

📂 Struttura Documentazione

—/document: Documentazione per il dominio Conto Termico.
—/document_harry: Documentazione per il dominio Ciclone Harry.

🧪 Testing

Il progetto include una suite di test per verificare il caricamento della configurazione e l'isolamento della cache:

bash

python3 -m pytest tests/

⚠️ Gestione Errori

Il sistema gestisce automaticamente:

—Errore 503/Quota: Retry logic con backoff esponenziale.
—Errore 403 (Cache Scaduta): Auto-rigenerazione trasparente della sessione durante l'uso.