# App Rememberizer

## Introduzione

L'app Rememberizer è un'applicazione desktop che converte i tuoi file locali in vettori di embedding e li carica nella tua base di conoscenza Rememberizer. Questa integrazione senza soluzione di continuità consente alle applicazioni AI di cercare e fare riferimento ai tuoi file personali attraverso le capacità di ricerca semantica di Rememberizer, fornendo risposte basate sul tuo contenuto senza richiedere accesso diretto ai tuoi file.

## Vantaggi

* **Integrazione Sicura dei Dati:** Carica e elabora i tuoi file localmente senza condividere documenti completi con servizi AI di terze parti
* **Utilizzo dei Dati:** Trasforma i tuoi documenti locali in conoscenze preziose e ricercabili
* **Comprensione Semantica:** Sfrutta gli embedding vettoriali per abilitare la ricerca basata su concetti piuttosto che solo sul corrispondenza di parole chiave
* **Integrazione Potente con l'AI:** Collega la tua conoscenza a vari sistemi AI tra cui ChatGPT, Claude e applicazioni personalizzate
* **Controllo della Privacy:** Mantieni la proprietà dei tuoi dati rendendoli utili per gli assistenti AI

## Piattaforme Supportate

Attualmente, l'app Rememberizer è disponibile per:

* **macOS**: processori Intel e Apple Silicon (M1/M2/M3)

Supporto futuro pianificato (non ancora disponibile):

* Windows (in sviluppo)
* Linux (in fase di valutazione)

## Requisiti di Sistema

### Requisiti macOS

* macOS 10.15 (Catalina) o versione successiva
* Minimo 8GB di RAM (16GB raccomandati)
* 500MB di spazio libero su disco per l'applicazione
* Spazio di archiviazione aggiuntivo per la cache dei file elaborati
* Connessione a Internet per l'autenticazione e il caricamento degli embedding

### Accelerazione Hardware

* **Mac Apple Silicon:** Utilizza automaticamente PyTorch abilitato MPS per prestazioni ottimizzate
* **Mac Intel con GPU compatibile:** Può sfruttare l'accelerazione GPU per un'elaborazione più veloce
* **Sistemi solo CPU:** Torna all'elaborazione CPU con ottimizzazione intelligente

## Installazione

1. Scarica l'ultima versione di Rememberizer App dai [link forniti qui](#download-links)
2. Una volta completato il download, individua il file .dmg nella tua cartella di download e fai doppio clic su di esso
3. Nella finestra che appare, trascina l'icona di Rememberizer App nella cartella Applicazioni
4. Vai alla tua cartella Applicazioni e apri Rememberizer App
5. Se vedi un avviso di sicurezza, segui questi passaggi:
   * Apri Preferenze di Sistema > Sicurezza e Privacy
   * Clicca su "Apri Comunque" per autorizzare l'app
   * L'app è firmata in modo sicuro ma potrebbe attivare questo avviso al primo utilizzo

## Configurazione e Impostazione

### Configurazione Iniziale

1. **Accedi:** Avvia l'app e accedi con il tuo account Rememberizer. Si aprirà una finestra del browser per l'autenticazione.

<figure><img src="https://github.com/skydeckai/rememberizer-docs/blob/production/it/.gitbook/assets/rememberizer_app_sign_in.png" alt="Schermata di accesso all&#x27;app Rememberizer"><figcaption><p>Accedi per collegare il tuo account Rememberizer</p></figcaption></figure>

<figure><img src="https://github.com/skydeckai/rememberizer-docs/blob/production/it/.gitbook/assets/rememberizer_app_success_auth.png" alt="Schermata di autenticazione riuscita"><figcaption><p>Autenticazione riuscita</p></figcaption></figure>

2. **Aggiungi Fonti di Dati:** Dopo aver effettuato l'accesso, l'app funziona in background. Accedila dall'icona della barra dei menu. Aggiungi le cartelle contenenti i documenti che desideri elaborare.

<figure><img src="https://github.com/skydeckai/rememberizer-docs/blob/production/it/.gitbook/assets/rememberizer_app_add_folder_1.png" alt="Aggiunta di una cartella a Rememberizer"><figcaption><p>Accedi a Rememberizer dalla barra dei menu</p></figcaption></figure>

<figure><img src="https://github.com/skydeckai/rememberizer-docs/blob/production/it/.gitbook/assets/rememberizer_app_add_folder_2.png" alt="Dialogo di selezione della cartella"><figcaption><p>Seleziona le cartelle da aggiungere come fonti di dati</p></figcaption></figure>

3. **Elaborazione dei File:** L'app inizierà ad analizzare ed elaborare i file nelle cartelle selezionate. Questo comporta:
   * Scansione dei file e identificazione dei formati supportati
   * Suddivisione dei contenuti dei file in segmenti di dimensioni ottimali
   * Conversione del testo in embedding vettoriali
   * Caricamento di metadati e embedding nel tuo account Rememberizer

<figure><img src="https://github.com/skydeckai/rememberizer-docs/blob/production/it/.gitbook/assets/rememberizer_app_status.png" alt="Schermata di stato dell&#x27;app Rememberizer"><figcaption><p>Monitora lo stato di elaborazione nella scheda Stato</p></figcaption></figure>

### Configurazione Avanzata

L'app Rememberizer offre diverse opzioni di configurazione per ottimizzare le prestazioni:

1. **Elaborazione in Background:** Controlla quando avviene l'elaborazione dei file:
   * **Automatica (predefinita):** Elabora i file continuamente in background
   * **Manuale:** Elabora i file solo quando esplicitamente attivato
2. **Filtraggio dei Tipi di File:** Personalizza quali tipi di file vengono elaborati:
   * **Predefinito:** Elabora tutti i tipi di file supportati
   * **Personalizzato:** Specifica le estensioni dei file da includere o escludere
3. **Supporto per Gitignore:** Rispetta automaticamente le regole di `.gitignore` nei repository:
   * Previene l'elaborazione dei file esclusi
   * Mantiene la coerenza con le tue preferenze di controllo versione

## Tipi di File Supportati

L'app Rememberizer può elaborare un'ampia gamma di formati di file:

| Categoria      | Formati Supportati                                                                    |
| -------------- | ------------------------------------------------------------------------------------- |
| File di Testo  | .txt, .md, .rtf, .csv, .json, .xml, .yml, .yaml, e altro                              |
| Documenti      | .pdf, .doc, .docx, .odt, .pages                                                       |
| Presentazioni  | .ppt, .pptx, .key                                                                     |
| Fatture        | .xls, .xlsx, .numbers                                                                 |
| File di Codice | .py, .js, .java, .c, .cpp, .cs, .html, .css, .php, .r, .rb, .go, .rs, .swift, e altro |
| Configurazione | .ini, .conf, .config, .env                                                            |
| Dati           | .json, .xml, .csv, .tsv                                                               |

### Dimensioni del file e limitazioni del contenuto

* Dimensione massima del file: 50MB per file
* Estrazione massima di testo incorporato: 1.000.000 caratteri per file
* I file binari ed eseguibili non vengono elaborati
* I file protetti da password non possono essere elaborati
* I file corrotti possono essere saltati

## Sicurezza e Privacy

L'app Rememberizer implementa diverse misure di sicurezza:

1. **Elaborazione Locale:** L'elaborazione iniziale dei file avviene localmente sul tuo dispositivo
2. **Crittografia dei Contenuti:** Il contenuto del documento è crittografato prima della trasmissione
3. **Autenticazione Sicura:** OAuth2 con gestione sicura dei token
4. **Archiviazione Basata su Embedding:** Solo le rappresentazioni vettoriali (non il testo originale) sono archiviate a lungo termine
5. **Conformità a Gitignore:** Rispetta i modelli di esclusione per evitare l'elaborazione di file sensibili
6. **Comunicazione API Sicura:** Tutto il traffico API utilizza HTTPS con TLS 1.2+

### Utilizzo e Raccolta dei Dati

* L'app trasmette vettori di embedding e metadati minimi sui tuoi file
* I contenuti originali dei file non sono memorizzati permanentemente sui server di Rememberizer
* L'elaborazione avviene prima localmente con solo i dati necessari trasmessi
* Nessun tracciamento o analisi oltre a ciò che è necessario per la funzionalità del servizio

## Risoluzione dei problemi

### Problemi Comuni e Soluzioni

#### L'applicazione non si avvia

* Verifica la versione di macOS (richiesta 10.15 o superiore)
* Controlla lo spazio disponibile su disco (minimo 500MB)
* Assicurati di avere i permessi di amministratore per installare le applicazioni
* Prova a riavviare il computer

#### Problemi di autenticazione

* Controlla la tua connessione a Internet
* Verifica le credenziali del tuo account Rememberizer
* Cancella i cookie del browser e riprova
* Assicurati che nessun firewall stia bloccando la comunicazione

#### File Non Elaborate

* Conferma che il tipo di file sia supportato
* Controlla che le dimensioni dei file siano inferiori al limite di 50MB
* Verifica che i permessi della cartella consentano all'app di leggere i file
* Controlla la scheda Stato per messaggi di errore specifici
* Assicurati che i file non siano esclusi dalle regole di gitignore

#### Prestazioni di Elaborazione Lente

* Chiudi le applicazioni che richiedono molte risorse
* Aggiungi inizialmente meno cartelle, poi espandi
* Dai priorità ai file di testo più piccoli per un'elaborazione più veloce
* Abilita l'accelerazione GPU se disponibile
* Controlla lo spazio su disco disponibile (spazio basso può causare rallentamenti)

### Informazioni diagnostiche

L'app mantiene registri che possono aiutare a risolvere problemi:

1. Accedi al menu dell'app facendo clic sull'icona nella barra dei menu
2. Seleziona "Avanzate" > "Mostra registri"
3. Controlla i registri per messaggi di errore o avvisi
4. Se stai segnalando un problema, includi le sezioni di registro pertinenti

### Ripristinare l'App

Se si riscontrano problemi persistenti:

1. Esci dall'App Rememberizer
2. Apri il Terminale
3. Esegui: `defaults delete com.rememberizer.app`
4. Riavvia l'applicazione

## Link per il download

* Rememberizer App 1.6.1 ([macOS](https://www.dropbox.com/scl/fi/hzytquytxmuhpov67spru/rememberizer-app-1.6.1.dmg?rlkey=0p30ok9qt4e33ua8scomagzev\&st=8yys88d5\&dl=1)) - Vedi [Note di rilascio](#version-161-october-4th-2024)

Usa sempre l'ultima versione per beneficiare di aggiornamenti di sicurezza, correzioni di bug e nuove funzionalità.

## Note di rilascio

### Versione 1.6.1 (4 ottobre 2024)

#### Caratteristiche e Miglioramenti

* **Supporto per Cartelle Vuote**: Gli utenti possono ora aggiungere cartelle vuote come fonte di dati.
* **Supporto GPU e Miglioramenti delle Prestazioni**: Aggiunto supporto per l'accelerazione GPU per migliorare la velocità di elaborazione.
* **Programma di Embedding Migliorato**: Configurato per supportare la versione MPS di PyTorch, ottimizzando per build specifiche della macchina.
* **Rilevamento Intelligente della CPU**: Implementato il rilevamento del tipo di CPU per garantire che venga utilizzata la versione più adatta del programma di embedding.
* **Gestione Migliorata delle Fonti di Dati**: Utilizzato l'API Batch Delete per una cancellazione efficiente dei file nelle fonti di dati rimosse.
* **Supporto per Tutti i File di Testo Normale**: Abilitata l'elaborazione di vari tipi di file di testo normale.
* **Adesione alle Regole di Gitignore**: I file ignorati dalle regole di gitignore nei repository Git sono ora esclusi dall'elaborazione.
* **Miglioramenti Minori dell'Interfaccia Utente**: Miglioramenti all'interfaccia utente e alle prestazioni.

## Domande Frequenti

### Domande Generali

**D: L'app Rememberizer è gratuita da usare?**\
R: L'app è gratuita da scaricare, ma richiede un account Rememberizer che può avere livelli di abbonamento con vari limiti.

**D: L'app estrae testo dalle immagini?**\
R: Attualmente, l'app non esegue OCR (Riconoscimento Ottico dei Caratteri) sulle immagini.

**D: I miei file saranno condivisi con altri utenti?**\
R: No. I tuoi file vengono elaborati e incorporati privatamente solo per il tuo account.

### Domande Tecniche

**D: Quante risorse del mio sistema utilizzerà l'app?**\
R: L'app è progettata per funzionare in modo efficiente in background, ma l'uso delle risorse aumenta durante l'elaborazione iniziale di grandi cartelle.

**D: L'app deve essere sempre in esecuzione?**\
R: Per il monitoraggio continuo dei file e gli aggiornamenti, sì. Tuttavia, puoi scegliere di eseguirla solo quando necessario.

**D: Ci sono limiti al numero di file che posso elaborare?**\
R: I limiti dipendono dal livello del tuo account Rememberizer. L'app ti notificherà se ti avvicini a questi limiti.