foxAI - versione portatile per macOS (Apple Silicon)
=====================================================

Contenuto della cartella
  foxAI.app        l'applicazione
  foxAI.portable   indica a foxAI di tenere i dati in questa cartella: non cancellarlo
  data/            creata al primo avvio: impostazioni, modello, registri
  GUIDA.txt        guida rapida: gesti, chat, riordino, versione portatile

Requisiti
  Mac con processore Apple (M1 o successivi), macOS 13.3 o successivo.
  Circa 3 GB liberi nella cartella foxAI per il modello; 8 GB di RAM consigliati.

Prima apertura
  foxAI non è firmata con un certificato Apple, quindi macOS la blocca la prima volta.
  Copiare prima la cartella foxAI dove la si userà (chiavetta o disco), poi:
  - doppio clic su foxAI.app (macOS rifiuta di aprirla), poi Impostazioni di Sistema ->
    Privacy e sicurezza -> in fondo "Apri comunque" e conferma con la password o Touch ID;
  - su macOS 13 e 14 basta anche tasto destro (o ctrl+clic) su foxAI.app -> Apri -> Apri
    (da macOS 15 questa strada non c'è più).
  Basta una volta per ogni Mac.

  macOS può avviare le app scaricate da una copia isolata in sola lettura ("App
  Translocation"): da lì foxAI non troverebbe questa cartella, quindi si ferma e mostra il
  comando da usare. Si può anche prevenire: aprire il Terminale e scrivere (con uno spazio finale)
      xattr -dr com.apple.quarantine
  poi trascinare la cartella foxAI nella finestra del Terminale e premere Invio.
  Non servono diritti di amministratore; dopo il comando foxAI si apre anche senza
  passare dalle Impostazioni.

Dati
  Impostazioni, modello e registri restano in foxAI/data. I documenti riordinati vengono
  copiati (gli originali restano dove sono) in foxAI/Riordinati. Per un'altra cartella, a foxAI
  chiusa, scrivere in data/config.json: "organizer": { "destination_root": "Fatture" }
  (un percorso relativo resta sulla chiavetta; uno completo scrive su quel Mac).
  foxAI non crea cartelle né impostazioni nel Mac e usa solo il processore (non la scheda
  video). Le cache che macOS crea per foxAI durante la sessione (lettura dei PDF scansionati,
  motore delle finestre WebKit) si tolgono alla chiusura, o al lancio successivo su quel Mac
  dopo un arresto improvviso. Restano i file temporanei di WebKit nella cartella temporanea
  di sistema.

Primo avvio
  Con la connessione a internet foxAI scarica il modello (circa 2,1 GB) in foxAI/data/models;
  poi funziona anche senza rete. Il modello viene caricato tutto in memoria: non togliere la
  chiavetta mentre foxAI è aperta.

Mac aziendali gestiti
  Se l'amministratore vieta le app di sviluppatori non identificati, "Apri comunque" non
  compare e foxAI non può partire: serve l'autorizzazione del reparto IT.

Chiusura
  Icona di foxAI nella barra dei menu -> Esci. Poi si può espellere la chiavetta.
  Se foxAI è già aperta da questa cartella, un secondo avvio lo dice e si chiude.

Nuove versioni e licenza
  Gli aggiornamenti sono manuali: https://github.com/cc-forge/foxai/releases
  Sito: https://cristian-caroppo.pages.dev/foxai/
  foxAI è software libero (GPL-3.0-or-later, senza garanzia): licenza e componenti di terze
  parti in foxAI.app/Contents/Resources/licenses.
