# Aplicativo Rememberizer

## Introdução

O Rememberizer App é um aplicativo de desktop que converte seus arquivos locais em embeddings vetoriais e os envia para sua base de conhecimento Rememberizer. Essa integração perfeita permite que aplicações de IA pesquisem e façam referência aos seus arquivos pessoais por meio das capacidades de busca semântica do Rememberizer, fornecendo respostas com base no seu conteúdo sem exigir acesso direto aos seus arquivos.

## Benefícios

* **Integração de Dados Segura:** Faça upload e processe seus arquivos localmente sem compartilhar documentos completos com serviços de IA de terceiros
* **Utilização de Dados:** Transforme seus documentos locais em conhecimento valioso e pesquisável
* **Compreensão Semântica:** Aproveite embeddings vetoriais para permitir busca baseada em conceitos em vez de apenas correspondência de palavras-chave
* **Integração Poderosa de IA:** Conecte seu conhecimento a vários sistemas de IA, incluindo ChatGPT, Claude e aplicativos personalizados
* **Controle de Privacidade:** Mantenha a propriedade dos seus dados enquanto os torna úteis para assistentes de IA

## Plataformas Suportadas

Atualmente, o Rememberizer App está disponível para:

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

Suporte planejado para o futuro (ainda não disponível):

* Windows (em desenvolvimento)
* Linux (em consideração)

## Requisitos do Sistema

### Requisitos do macOS

* macOS 10.15 (Catalina) ou mais recente
* Mínimo de 8GB de RAM (16GB recomendado)
* 500MB de espaço livre em disco para o aplicativo
* Espaço de armazenamento adicional para caches de arquivos processados
* Conexão à internet para autenticação e upload de embeddings

### Aceleração de Hardware

* **Macs com Apple Silicon:** Usa automaticamente o PyTorch com suporte a MPS para desempenho otimizado
* **Macs Intel com GPU compatível:** Pode aproveitar a aceleração da GPU para processamento mais rápido
* **Sistemas apenas com CPU:** Retorna ao processamento da CPU com otimização inteligente

## Instalação

1. Baixe a versão mais recente do Rememberizer App a partir [dos links fornecidos aqui](#download-links)
2. Assim que o download estiver completo, localize o arquivo .dmg na sua pasta de downloads e clique duas vezes nele
3. Na janela que aparece, arraste o ícone do Rememberizer App para a pasta Aplicativos
4. Navegue até a sua pasta Aplicativos e abra o Rememberizer App
5. Se você ver um aviso de segurança, siga estas etapas:
   * Abra Preferências do Sistema > Segurança e Privacidade
   * Clique em "Abrir assim mesmo" para autorizar o aplicativo
   * O aplicativo está assinado de forma segura, mas pode acionar esse aviso na primeira utilização

## Configuração e Configuração

### Configuração Inicial

1. **Entrar:** Inicie o aplicativo e faça login com sua conta Rememberizer. Uma janela do navegador será aberta para autenticação.

<figure><img src="https://606058861-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDrEOD8oYxrWDlC9WhJ3K%2Fuploads%2Fgit-blob-6e616a775371b8f25a8b5f47b2a72729b56bb053%2Frememberizer_app_sign_in.png?alt=media" alt="Tela de login do aplicativo Rememberizer"><figcaption><p>Faça login para conectar sua conta Rememberizer</p></figcaption></figure>

<figure><img src="https://606058861-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDrEOD8oYxrWDlC9WhJ3K%2Fuploads%2Fgit-blob-12185aad147ecdea4879684de4851c47957ce98c%2Frememberizer_app_success_auth.png?alt=media" alt="Tela de autenticação bem-sucedida"><figcaption><p>Autenticação bem-sucedida</p></figcaption></figure>

2. **Adicionar Fontes de Dados:** Após fazer login, o aplicativo será executado em segundo plano. Acesse-o pelo ícone na barra de menu. Adicione pastas contendo documentos que você deseja processar.

<figure><img src="https://606058861-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDrEOD8oYxrWDlC9WhJ3K%2Fuploads%2Fgit-blob-8c1d1ffa3dfdc939ed3bd754df1b4599b519b0bd%2Frememberizer_app_add_folder_1.png?alt=media" alt="Adicionando uma pasta ao Rememberizer"><figcaption><p>Acesse o Rememberizer pela barra de menu</p></figcaption></figure>

<figure><img src="https://606058861-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDrEOD8oYxrWDlC9WhJ3K%2Fuploads%2Fgit-blob-e48ad98214856c359c7d7683247dc345dbc82faa%2Frememberizer_app_add_folder_2.png?alt=media" alt="Diálogo de seleção de pasta"><figcaption><p>Selecione pastas para adicionar como fontes de dados</p></figcaption></figure>

3. **Processando Arquivos:** O aplicativo começará a analisar e processar arquivos nas pastas selecionadas. Isso envolve:
   * Escanear arquivos e identificar formatos suportados
   * Dividir o conteúdo dos arquivos em segmentos de tamanho otimizado
   * Converter texto em embeddings vetoriais
   * Fazer upload de metadados e embeddings para sua conta Rememberizer

<figure><img src="https://606058861-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDrEOD8oYxrWDlC9WhJ3K%2Fuploads%2Fgit-blob-717f366349317a1947ea7258f6a88f075f3dcee6%2Frememberizer_app_status.png?alt=media" alt="Tela de status do aplicativo Rememberizer"><figcaption><p>Monitore o status do processamento na aba Status</p></figcaption></figure>

### Configuração Avançada

O aplicativo Rememberizer oferece várias opções de configuração para otimizar o desempenho:

1. **Processamento em Segundo Plano:** Controla quando o processamento de arquivos ocorre:
   * **Automático (padrão):** Processa arquivos continuamente em segundo plano
   * **Manual:** Processa arquivos apenas quando explicitamente acionado
2. **Filtragem de Tipos de Arquivo:** Personalize quais tipos de arquivo são processados:
   * **Padrão:** Processa todos os tipos de arquivo suportados
   * **Personalizado:** Especifique as extensões de arquivo a incluir ou excluir
3. **Suporte a Gitignore:** Respeita automaticamente as regras do `.gitignore` em repositórios:
   * Impede o processamento de arquivos excluídos
   * Mantém a consistência com suas preferências de controle de versão

## Tipos de Arquivos Suportados

O Aplicativo Rememberizer pode processar uma ampla gama de formatos de arquivo:

| Categoria          | Formatos Suportados                                                                  |
| ------------------ | ------------------------------------------------------------------------------------ |
| Arquivos de Texto  | .txt, .md, .rtf, .csv, .json, .xml, .yml, .yaml, e mais                              |
| Documentos         | .pdf, .doc, .docx, .odt, .pages                                                      |
| Apresentações      | .ppt, .pptx, .key                                                                    |
| Planilhas          | .xls, .xlsx, .numbers                                                                |
| Arquivos de Código | .py, .js, .java, .c, .cpp, .cs, .html, .css, .php, .r, .rb, .go, .rs, .swift, e mais |
| Configuração       | .ini, .conf, .config, .env                                                           |
| Dados              | .json, .xml, .csv, .tsv                                                              |

### Limitações de Tamanho de Arquivo e Conteúdo

* Tamanho máximo do arquivo: 50MB por arquivo
* Extração máxima de texto incorporado: 1.000.000 caracteres por arquivo
* Arquivos binários e executáveis não são processados
* Arquivos protegidos por senha não podem ser processados
* Arquivos corrompidos podem ser ignorados

## Segurança e Privacidade

O aplicativo Rememberizer implementa várias medidas de segurança:

1. **Processamento Local:** O processamento inicial de arquivos ocorre localmente em sua máquina
2. **Criptografia de Conteúdo:** O conteúdo do documento é criptografado antes da transmissão
3. **Autenticação Segura:** OAuth2 com gerenciamento seguro de tokens
4. **Armazenamento Baseado em Embedding:** Apenas representações vetoriais (não o texto original) são armazenadas a longo prazo
5. **Conformidade com Gitignore:** Respeita padrões de exclusão para evitar o processamento de arquivos sensíveis
6. **Comunicação Segura da API:** Todo o tráfego da API utiliza HTTPS com TLS 1.2+

### Uso e Coleta de Dados

* O aplicativo transmite embeddings vetoriais e metadados mínimos sobre seus arquivos
* O conteúdo original dos arquivos não é armazenado permanentemente nos servidores do Rememberizer
* O processamento ocorre localmente primeiro, com apenas os dados necessários transmitidos
* Nenhum rastreamento ou análise além do que é necessário para a funcionalidade do serviço

## Solução de Problemas

### Problemas Comuns e Soluções

#### O Aplicativo Não Inicia

* Verifique a versão do macOS (10.15 ou mais recente é necessário)
* Verifique o espaço disponível em disco (mínimo de 500MB)
* Certifique-se de que você tem permissões de administrador para instalar aplicativos
* Tente reiniciar seu computador

#### Problemas de Autenticação

* Verifique sua conexão com a internet
* Verifique as credenciais da sua conta Rememberizer
* Limpe os cookies do navegador e tente novamente
* Certifique-se de que nenhum firewall está bloqueando a comunicação

#### Arquivos Não Processados

* Confirme se o tipo de arquivo é suportado
* Verifique se os tamanhos dos arquivos estão abaixo do limite de 50MB
* Verifique se as permissões da pasta permitem que o aplicativo leia os arquivos
* Verifique a aba Status para mensagens de erro específicas
* Certifique-se de que os arquivos não estão sendo excluídos pelas regras do gitignore

#### Desempenho Lento de Processamento

* Feche aplicativos que consomem muitos recursos
* Adicione menos pastas inicialmente, depois expanda
* Priorize arquivos de texto menores para um processamento mais rápido
* Ative a aceleração de GPU se disponível
* Verifique o espaço em disco disponível (espaço baixo pode causar lentidão)

### Informações de Diagnóstico

O aplicativo mantém registros que podem ajudar a solucionar problemas:

1. Acesse o menu do aplicativo clicando no ícone na barra de menu
2. Selecione "Avançado" > "Mostrar Registros"
3. Revise os registros em busca de mensagens de erro ou avisos
4. Se estiver relatando um problema, inclua seções relevantes dos registros

### Redefinindo o App

Se estiver enfrentando problemas persistentes:

1. Feche o App Rememberizer
2. Abra o Terminal
3. Execute: `defaults delete com.rememberizer.app`
4. Reinicie o aplicativo

## Links de Download

* Aplicativo Rememberizer 1.6.1 ([macOS](https://www.dropbox.com/scl/fi/hzytquytxmuhpov67spru/rememberizer-app-1.6.1.dmg?rlkey=0p30ok9qt4e33ua8scomagzev\&st=8yys88d5\&dl=1)) - Veja [Notas de Lançamento](#version-161-october-4th-2024)

Sempre use a versão mais recente para se beneficiar de atualizações de segurança, correções de bugs e novos recursos.

## Notas de Lançamento

### Versão 1.6.1 (4 de outubro de 2024)

#### Recursos e Melhorias

* **Suporte para Pastas Vazias**: Os usuários agora podem adicionar pastas vazias como uma fonte de dados.
* **Suporte a GPU e Melhorias de Desempenho**: Adicionado suporte para aceleração por GPU para melhorar a velocidade de processamento.
* **Programa de Embedding Aprimorado**: Configurado para suportar a versão MPS do PyTorch, otimizando para compilações específicas de máquina.
* **Detecção Inteligente de CPU**: Implementada a detecção do tipo de CPU para garantir que a versão mais adequada do programa de embedding seja utilizada.
* **Gerenciamento Aprimorado de Fontes de Dados**: Utilizado a API de Exclusão em Lote para exclusão eficiente de arquivos em fontes de dados removidas.
* **Suporte para Todos os Arquivos de Texto Simples**: Habilitado o processamento de vários tipos de arquivos de texto simples.
* **Adesão às Regras do Gitignore**: Arquivos ignorados pelas regras do gitignore em repositórios Git agora são excluídos do processamento.
* **Melhorias Menores na Interface do Usuário**: Aprimoramentos na interface do usuário e no desempenho.

## Perguntas Frequentes

### Perguntas Gerais

**P: O aplicativo Rememberizer é gratuito para usar?**\
R: O aplicativo é gratuito para baixar, mas requer uma conta Rememberizer que pode ter níveis de assinatura com vários limites.

**P: O aplicativo extrai texto de imagens?**\
R: Atualmente, o aplicativo não realiza OCR (Reconhecimento Óptico de Caracteres) em imagens.

**P: Meus arquivos serão compartilhados com outros usuários?**\
R: Não. Seus arquivos são processados e incorporados de forma privada apenas para sua conta.

### Perguntas Técnicas

**P: Quanto dos recursos do meu sistema o aplicativo usará?**\
R: O aplicativo foi projetado para funcionar de forma eficiente em segundo plano, mas o uso de recursos aumenta durante o processamento inicial de pastas grandes.

**P: O aplicativo precisa estar em execução o tempo todo?**\
R: Para monitoramento contínuo de arquivos e atualizações, sim. No entanto, você pode optar por executá-lo apenas quando necessário.

**P: Existem limites para quantos arquivos posso processar?**\
R: Os limites dependem do nível da sua conta Rememberizer. O aplicativo o notificará se você se aproximar desses limites.