Automazione Google Calendar & Gemini

1. Installazione Dipendenze

Esegui il comando per installare le librerie necessarie:

pip install google-genai google-api-python-client google-auth-httplib2 google-auth-oauthlib pydantic pillow python-dotenv

2. Configurazione della Sicurezza

Non esporre mai le chiavi. Crea i file di configurazione per gestire i segreti.

.env

Crea un file chiamato .env nella root del progetto:

nano .env

Inserisci la tua API Key di Gemini:

GEMINI_API_KEY="...tua_chiave..."

3. Setup Google Cloud Console

Questa procedura autorizza lo script a interagire con il tuo calendario.

1. Vai su Google Cloud Console.
2. Crea un nuovo progetto (es. Automazione-Orario).
3. Nel menu a sinistra, vai su API e servizi -> Libreria.
4. Cerca Google Calendar API e clicca su Abilita.

3.1 Schermata di Consenso OAuth

1. Vai su API e servizi -> Schermata consenso OAuth.
2. Seleziona Esterno e clicca Crea.
3. Compila i campi obbligatori (Nome app, email di contatto). Salva e continua.
4. Scorri fino a Utenti di test -> Aggiungi utenti.
5. Inserisci l'email del tuo account Google. (Passaggio fondamentale per evitare l'errore 403 access_denied).

3.2 Creazione Credenziali

1. Vai su API e servizi -> Credenziali.
2. Clicca Crea credenziali -> ID client OAuth.
3. Tipo di applicazione: App desktop. Assegna un nome e crea.
4. Scarica il file JSON generato.
5. Sposta il file nella cartella del progetto (llm_calendar/) e rinominalo in credentials.json.

4. API Key di Gemini

1. Vai su Google AI Studio.
2. Clicca su Create API Key.
3. Seleziona il progetto Cloud appena creato.
4. Copia la chiave e incollala nel file .env creato allo Step 2.

5. Esecuzione e Autenticazione

Assicurati che l'immagine dell'orario sia presente nella cartella con il nome orario.png.

Lancia lo script:

python auto_calendar.py

• Primo avvio: Si aprirà il browser per l'autenticazione. Accedi con l'account Google inserito negli Utenti di Test.
• Sicurezza: Se appare "Google non ha verificato questa app", clicca su Avanzate -> Vai a [Nome App] (non sicuro).
• Permessi: Concedi i permessi per gestire il calendario.
• Lo script genererà automaticamente token.json per gestire le autenticazioni future.