diff --git a/perguntas-frequentes.md b/perguntas-frequentes.md new file mode 100644 index 00000000..8226c2a5 --- /dev/null +++ b/perguntas-frequentes.md @@ -0,0 +1,318 @@ +# Perguntas Frequentes + +## Perguntas Gerais + +### O que é o NOMAD? +O NOMAD é um servidor pessoal que dá acesso a conhecimento, educação e assistência de IA sem a necessidade de conexão com a internet. Ele roda no seu próprio hardware, mantendo seus dados privados e acessíveis a qualquer momento. + +### Preciso de internet para usar o NOMAD? +Não — esse é justamente o propósito. Uma vez que o conteúdo é baixado, tudo funciona offline. Você só precisa de internet para: +- Baixar novo conteúdo +- Atualizar o software +- Sincronizar as versões mais recentes da Wikipédia, mapas, etc. + +### Qual sistema operacional o NOMAD necessita? +Linux baseado em Debian. **Ubuntu 26.04 LTS é o que recomendamos e testamos** para novas instalações. + +Ubuntu 24.04 LTS e Debian 12 também são suportados, portanto não há necessidade de reinstalar se você já está em um deles. Usuários Windows podem seguir o [guia WSL2](https://www.projectnomad.us/install/wsl2), que é mantido pela comunidade. + +macOS e distribuições não-Debian como Fedora ou Arch não possuem suporte oficial. O NOMAD não precisa de ambiente de desktop, então o Ubuntu Server é uma boa escolha se você está confortável com o terminal. + +Para um passo a passo completo incluindo a instalação do Ubuntu, consulte o [Guia de Instalação](https://www.projectnomad.us/install). + +### Qual hardware eu preciso? +O NOMAD foi projetado para hardware robusto, especialmente se você deseja usar os recursos de IA. Recomendado: +- CPU moderna com múltiplos núcleos (AMD Ryzen 7 com gráficos Radeon é o favorito da comunidade) +- 16GB+ de RAM (32GB+ para melhor desempenho de IA) +- Armazenamento SSD (o tamanho depende do conteúdo — mínimo de 500GB, 1TB+ recomendado) +- GPU NVIDIA ou AMD recomendada para respostas de IA mais rápidas + +**Para recomendações detalhadas de montagem em três faixas de preço ($150–$1.000+), consulte o [Guia de Hardware](https://www.projectnomad.us/hardware).** + +### Quanto espaço de armazenamento eu preciso? +Depende do que você baixar: +- Wikipédia completa: ~95GB +- Cursos da Khan Academy: ~50GB +- Referências médicas: ~500MB +- Mapas de estados dos EUA: ~2-3GB cada +- Modelos de IA: 10-40GB dependendo do modelo + +Comece com o essencial e adicione mais conforme necessário. + +--- + +## Perguntas sobre Conteúdo + +### Como adiciono mais conteúdo da Wikipédia? +1. Vá em **Configurações** (menu hambúrguer → Configurações) +2. Clique em **Explorador de Conteúdo** +3. Navegue pelos pacotes de Wikipédia disponíveis +4. Clique em Baixar nos itens desejados + +Você também pode usar o **Explorador de Conteúdo** para navegar por todo o conteúdo ZIM disponível além da Wikipédia. + +### Como adiciono mais cursos educacionais? +1. Abra o **Kolibri** +2. Entre como administrador +3. Vá em **Dispositivo → Canais** +4. Navegue e importe os canais disponíveis + +### O conteúdo é atualizado? +O conteúdo é tão atual quanto a data do último download. Os snapshots da Wikipédia são atualizados tipicamente uma vez por mês. Verifique os nomes dos arquivos ou descrições para conferir as datas. + +### Posso adicionar meus próprios arquivos? +Sim — com a Base de Conhecimento. Envie PDFs, arquivos de texto e outros documentos para a [Base de Conhecimento](/knowledge-base), e a IA poderá referenciá-los ao responder suas perguntas. Isso utiliza busca semântica para encontrar informações relevantes nos seus arquivos enviados. + +Para conteúdo Kiwix, o NOMAD utiliza arquivos ZIM padrão. Para conteúdo educacional, o Kolibri utiliza seu próprio formato de canal. + +### O que são os níveis de coleções curadas? +Ao selecionar conteúdo no assistente de Configuração Fácil ou no Explorador de Conteúdo, as coleções são organizadas em três níveis: +- **Essencial** — Conteúdo principal da categoria (menor download) +- **Padrão** — Essencial mais conteúdo útil adicional +- **Completo** — Tudo disponível para a categoria (maior download) + +Isso ajuda a equilibrar a cobertura de conteúdo com o uso de armazenamento. + +--- + +## Perguntas sobre IA + +### Como uso o chat de IA? +1. Vá ao [Chat de IA](/chat) a partir do Centro de Comando +2. Digite sua pergunta ou solicitação +3. A IA responde em estilo conversacional + +A IA precisa ser instalada primeiro — ative-a durante a Configuração Fácil ou instale-a pela página do [Depósito de Recursos](/supply-depot). + +### Como envio documentos para a Base de Conhecimento? +1. Vá em **[Base de Conhecimento →](/knowledge-base)** +2. Envie seus documentos (PDFs, arquivos de texto, etc.) +3. Os documentos são processados e indexados automaticamente +4. Faça perguntas no Chat de IA — a IA referenciará seus documentos enviados quando relevante + +Você também pode remover documentos da Base de Conhecimento quando não forem mais necessários. + +A documentação do NOMAD é adicionada automaticamente à Base de Conhecimento quando o Assistente de IA é instalado. + +### O que é o Benchmark do Sistema? +O Benchmark do Sistema testa o desempenho do seu hardware e gera uma Pontuação NOMAD — uma composição ponderada de desempenho de CPU, memória, disco e IA. Você pode criar uma Builder Tag (uma identidade temática NOMAD como "Tactical-Llama-1234") e compartilhar seus resultados no [ranking da comunidade](https://benchmark.projectnomad.us). + +Vá em **[Benchmark do Sistema →](/settings/benchmark)** para executar um. + +### O que é o Canal de Acesso Antecipado? +O Canal de Acesso Antecipado permite que você opte por receber versões candidatas a lançamento com os recursos e melhorias mais recentes antes de chegarem às versões estáveis. Você pode ativá-lo ou desativá-lo em **Configurações → Verificar Atualizações**. Versões de acesso antecipado podem conter bugs — se você prefere estabilidade, permaneça no canal estável. + +--- + +## Solução de Problemas + +### Um recurso não carrega ou exibe uma página em branco + +**Tente estes passos:** +1. Aguarde 30 segundos — alguns recursos demoram para iniciar +2. Atualize a página (Ctrl+R ou Cmd+R) +3. Volte ao Centro de Comando e tente novamente +4. Verifique em Configurações → Sistema se o serviço está em execução +5. Tente reiniciar o serviço (Parar, depois Iniciar no Depósito de Recursos) + +### Os mapas exibem uma área cinza/em branco + +O recurso de Mapas requer dados de mapa baixados. Se você vê uma área em branco: +1. Vá em **Configurações → Gerenciador de Mapas** +2. Baixe as regiões de mapa da sua área +3. Aguarde a conclusão dos downloads +4. Retorne aos Mapas e atualize a página + +### ERRO: Failed to load the XML library file '/data/kiwix-library.xml' + +Isso geralmente significa que o serviço da Biblioteca de Informações iniciou antes de seu índice de biblioteca Kiwix ser totalmente inicializado. + +Tente este procedimento de recuperação: +1. Vá ao **[Depósito de Recursos](/supply-depot)** +2. Pare a **Biblioteca de Informações (Kiwix)** +3. Aguarde 10-15 segundos e inicie novamente +4. Se o erro persistir, execute **Forçar Reinstalação** para a Biblioteca de Informações na mesma página + +Após a conclusão da reinicialização/reinstalação, atualize a página da Biblioteca de Informações. + +### As respostas da IA estão lentas + +A IA local requer poder computacional significativo. Para melhorar a velocidade: +- **Adicione uma GPU** — Uma GPU NVIDIA com o NVIDIA Container Toolkit pode melhorar a velocidade da IA em 10-20x ou mais +- Feche outras aplicações no servidor +- Garanta resfriamento adequado (superaquecimento causa limitação de desempenho) +- Considere usar um modelo de IA menor/mais rápido, se disponível + +### Como habilito a aceleração por GPU para IA? + +O NOMAD detecta automaticamente GPUs NVIDIA quando o NVIDIA Container Toolkit está instalado no sistema hospedeiro. Para configurar a aceleração por GPU: + +1. **Instale uma GPU NVIDIA** no seu servidor (se ainda não tiver uma) +2. **Instale o NVIDIA Container Toolkit** no hospedeiro — siga o [guia oficial de instalação](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) +3. **Reinstale o Assistente de IA** — Vá ao [Depósito de Recursos](/supply-depot), encontre o Assistente de IA e clique em **Forçar Reinstalação** + +O NOMAD detectará a GPU durante a instalação e configurará a IA para usá-la automaticamente. Você verá "NVIDIA container runtime detected" no progresso da instalação. + +**Dica:** Execute um [Benchmark do Sistema](/settings/benchmark) antes e depois para ver a diferença. Sistemas com aceleração por GPU tipicamente alcançam 100+ tokens por segundo contra 10-15 apenas com CPU. + +### Adicionei/troquei minha GPU, mas a IA continua lenta + +Quando você adiciona ou troca uma GPU, o NOMAD precisa reconfigurar o contêiner de IA para usá-la: + +1. Certifique-se de que o **NVIDIA Container Toolkit** está instalado no hospedeiro +2. Vá ao **[Depósito de Recursos](/supply-depot)** +3. Encontre o **Assistente de IA** e clique em **Forçar Reinstalação** + +Forçar Reinstalação recria o contêiner de IA com suporte a GPU habilitado. Sem este passo, a IA continua rodando apenas na CPU. + +### Vejo um aviso "GPU passthrough not working" + +O NOMAD verifica se sua GPU está realmente acessível dentro do contêiner de IA. Se uma GPU é detectada no hospedeiro mas não está funcionando dentro do contêiner, você verá um banner de aviso nas páginas de Informações do Sistema e Configurações de IA. Clique no botão **"Fix: Reinstall AI Assistant"** para recriar o contêiner com acesso adequado à GPU. Isso preserva seus modelos de IA baixados. + +### Chat de IA indisponível + +A página do Chat de IA requer que o Assistente de IA seja instalado primeiro: +1. Vá ao **[Depósito de Recursos](/supply-depot)** +2. Instale o **Assistente de IA** +3. Aguarde a conclusão da instalação +4. O Chat de IA estará então acessível pela tela inicial ou em [Chat](/chat) + +### Envio para a Base de Conhecimento travado + +Se o envio de um documento parece travado na Base de Conhecimento: +1. Verifique se o Assistente de IA está em execução em **Configurações → Depósito de Recursos** +2. Documentos grandes levam tempo para processar — aguarde alguns minutos +3. Tente enviar um documento menor para verificar se o sistema está funcionando +4. Verifique **Configurações → Sistema** para mensagens de erro + +### O benchmark não envia para o ranking + +Para compartilhar resultados no ranking da comunidade: +- Você deve executar um **Benchmark Completo** (não apenas Sistema ou apenas IA) +- O benchmark deve incluir resultados de IA (o Assistente de IA deve estar instalado e funcionando) +- Sua pontuação deve ser maior que qualquer envio anterior do mesmo hardware + +Se o envio falhar, verifique a mensagem de erro para mais detalhes. + +### "Service unavailable" ou erros de conexão + +O serviço pode ainda estar inicializando. Aguarde 1-2 minutos e tente novamente. + +Se o problema persistir: +1. Vá em **Configurações → Depósito de Recursos** +2. Encontre o serviço problemático +3. Clique em **Reiniciar** +4. Aguarde 30 segundos e tente novamente + +### Downloads travados ou falhando + +1. Verifique sua conexão com a internet +2. Vá em **Configurações** e verifique o armazenamento disponível +3. Se o armazenamento estiver cheio, exclua conteúdo não utilizado +4. Cancele o download travado e tente novamente + +### O servidor não inicia + +Se você não consegue acessar o Centro de Comando: +1. Verifique se o hardware do servidor está ligado +2. Verifique a conectividade de rede +3. Tente acessar diretamente pelo endereço IP do servidor +4. Verifique os logs do servidor se você tem acesso ao console + +### Esqueci minha senha do Kolibri + +As senhas do Kolibri são gerenciadas separadamente: +1. Se você é administrador, pode redefinir senhas de usuários no gerenciamento de usuários do Kolibri +2. Se você esqueceu a senha de administrador, pode ser necessário redefini-la via linha de comando (entre em contato com seu administrador) + +--- + +## Atualizações e Manutenção + +### Como atualizo o NOMAD? +1. Vá em **Configurações → Verificar Atualizações** +2. Se uma atualização estiver disponível, clique para instalar +3. O sistema baixará as atualizações e reiniciará automaticamente +4. Isso geralmente leva de 2 a 5 minutos + +### Devo atualizar regularmente? +Sim, enquanto você tiver acesso à internet. As atualizações incluem: +- Correções de bugs +- Novos recursos +- Melhorias de segurança +- Melhorias de desempenho + +### O NOMAD pode se atualizar automaticamente? +Sim. O NOMAD pode manter seu software, seus aplicativos instalados e seu conteúdo atualizados por conta própria. As atualizações automáticas são **opcionais e desativadas por padrão** — você ativa o que quiser em **Configurações → Atualizações** (e, para aplicativos, um controle individual no Depósito de Recursos). Elas só executam dentro de uma janela de horário que você escolhe, após verificações de segurança, e nunca aplicam saltos de versão principal automaticamente. Consulte o **[guia de Atualizações](/docs/updates)** para um passo a passo completo. + +### Como atualizo o conteúdo (Wikipédia, etc.)? +As atualizações de conteúdo são separadas das atualizações de software: +1. Vá em **Configurações → Gerenciador de Conteúdo** ou **Explorador de Conteúdo** +2. Verifique se há versões mais recentes do seu conteúdo instalado +3. Baixe as versões atualizadas conforme necessário + +Você também pode ativar **atualizações automáticas de conteúdo** para que bibliotecas Wikipedia/ZIM e regiões de mapa instaladas se atualizem sozinhas durante a noite — consulte o [guia de Atualizações](/docs/updates). + +Dica: Novos snapshots da Wikipédia são lançados aproximadamente uma vez por mês. + +### O que acontece se uma atualização falhar? +O sistema foi projetado para se recuperar de forma segura. Se uma atualização falhar: +1. A versão anterior deve continuar funcionando +2. Tente a atualização novamente mais tarde +3. Verifique Configurações → Sistema para mensagens de erro + +### Manutenção via Linha de Comando + +Para solução de problemas avançada ou quando você não consegue acessar a interface web, o NOMAD inclui scripts auxiliares em `/opt/project-nomad`: + +**Iniciar todos os serviços:** +```bash +sudo bash /opt/project-nomad/start_nomad.sh +``` + +**Parar todos os serviços:** +```bash +sudo bash /opt/project-nomad/stop_nomad.sh +``` + +**Atualizar o Centro de Comando:** +```bash +sudo bash /opt/project-nomad/update_nomad.sh +``` +*Nota: Isso atualiza apenas o Centro de Comando, não os aplicativos individuais. Atualize os aplicativos pela interface web.* + +**Desinstalar o NOMAD:** +```bash +curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/uninstall_nomad.sh -o uninstall_nomad.sh +sudo bash uninstall_nomad.sh +``` +*Aviso: Isso não pode ser desfeito. Todos os dados serão excluídos.* + +--- + +## Privacidade e Segurança + +### Meus dados são privados? +Sim. O NOMAD roda inteiramente no seu hardware. Suas buscas, conversas com IA e dados de uso nunca saem do seu servidor. + +### Outras pessoas podem acessar meu servidor? +Por padrão, o NOMAD é acessível na sua rede local. Qualquer pessoa na mesma rede pode acessá-lo. Para redes públicas, considere medidas de segurança adicionais. + +### A IA envia dados para algum lugar? +Não. A IA roda completamente de forma local. Suas conversas não são enviadas para nenhum serviço externo. O chat de IA é integrado ao Centro de Comando — não há serviço separado para configurar. + +--- + +## Obtendo Mais Ajuda + +### A IA pode ajudar +Tente fazer uma pergunta no [Chat de IA](/chat). A IA local pode responder perguntas sobre diversos tópicos, incluindo solução de problemas técnicos. Se você enviou a documentação do NOMAD para a Base de Conhecimento, ela também pode ajudar com perguntas específicas sobre o NOMAD. + +### Consulte a documentação +Você está na documentação agora. Use o menu para encontrar tópicos específicos. + +### Junte-se à comunidade +Obtenha ajuda de outros usuários do NOMAD no **[Discord](https://discord.com/invite/crosstalksolutions)**. + +### Notas de Versão +Veja o que mudou em cada versão: **[Notas de Versão](/docs/release-notes)** diff --git a/primeiros-passos.md b/primeiros-passos.md new file mode 100644 index 00000000..71a51fb0 --- /dev/null +++ b/primeiros-passos.md @@ -0,0 +1,286 @@ +# Primeiros Passos com o NOMAD + +Este guia vai ajudá-lo a aproveitar ao máximo seu servidor NOMAD. + +--- + +## Requisitos do Sistema + +Se você já tem o NOMAD em execução, pode pular esta seção. Ela está aqui para quando você estiver planejando um segundo servidor, migrando para um hardware diferente ou ajudando outra pessoa a se configurar. + +### Sistema Operacional + +O NOMAD roda em Linux baseado em Debian. + +| Nível de suporte | Sistema operacional | +|---|---| +| **Recomendado** | Ubuntu 26.04 LTS | +| **Também suportado** | Ubuntu 24.04 LTS, Debian 12 | +| **Suporte da comunidade** | Windows via WSL2, outros derivados Debian | + +Ubuntu 26.04 LTS é a versão na qual testamos e a que recomendamos para novas instalações. Se você já está usando 24.04 LTS ou Debian 12, não há necessidade de reinstalar, ambos ainda são suportados. + +Ubuntu Desktop é a escolha mais amigável se você vem do Windows ou macOS. Ubuntu Server funciona igualmente bem se você está confortável com o terminal, e o NOMAD não precisa de ambiente de desktop de qualquer forma, já que tudo é acessado pelo navegador. + +macOS e distribuições não-Debian como Fedora ou Arch não possuem suporte oficial. + +### Hardware + +O NOMAD em si é leve. O que determina seus requisitos é o conteúdo e as ferramentas que você escolhe instalar, e se deseja rodar IA localmente. + +**Mínimo, sem IA local:** + +- Processador dual-core de 2 GHz +- 4 GB de RAM +- 5 GB de espaço livre em disco, mais espaço para o conteúdo que você baixar + +**Recomendado, com IA local:** + +- AMD Ryzen 7 ou Intel Core i7 ou superior +- 32 GB de RAM +- NVIDIA RTX 3060 ou equivalente AMD, mais VRAM permite rodar modelos maiores +- 250 GB ou mais de espaço livre em disco, preferencialmente um SSD + +Uma conexão estável com a internet é necessária apenas durante a instalação. Depois disso, o NOMAD foi projetado para funcionar totalmente offline. + +### Uma nota sobre drivers de GPU + +O instalador configura o Docker e o NVIDIA Container Toolkit para você, mas **não** instala o driver de GPU em si. Você precisa tê-lo no hospedeiro previamente. + +No Ubuntu, a maneira mais fácil é marcar **"Instalar drivers de terceiros para gráficos e hardware Wi-Fi"** durante a instalação. Se você pulou essa etapa, ou adicionou a GPU depois, instale o driver primeiro e então use **Forçar Reinstalação** no Assistente de IA no [Depósito de Recursos](/supply-depot) para detectá-lo. + +Sem uma GPU, o Assistente de IA ainda funciona. Ele apenas roda na CPU, o que é consideravelmente mais lento. + +--- + +## Assistente de Configuração Fácil + +Se esta é sua primeira vez usando o NOMAD, o assistente de Configuração Fácil vai ajudá-lo a configurar tudo. + +**[Iniciar Configuração Fácil →](/easy-setup)** + +![Assistente de Configuração Fácil — Passo 1: Escolha suas capacidades](/docs/easy-setup-step1.webp) + +O assistente guia você por quatro passos simples: +1. **Capacidades** — Escolha o que habilitar: Biblioteca de Informações, Assistente de IA, Plataforma Educacional, Mapas, Ferramentas de Dados e Notas +2. **Mapas** — Selecione regiões geográficas para mapas offline +3. **Conteúdo** — Escolha coleções curadas de conteúdo nos níveis Essencial, Padrão ou Completo + +![Níveis de conteúdo — Essencial, Padrão e Completo](/docs/easy-setup-tiers.webp) +4. **Revisão** — Confirme suas seleções e inicie os downloads + +Dependendo do que você selecionou, os downloads podem demorar. Você pode acompanhar o progresso na área de Configurações, continuar usando recursos já instalados ou deixar o servidor ligado durante a noite para downloads grandes. + +--- + +## Conhecendo Suas Ferramentas + +### Biblioteca de Informações — Conhecimento Offline (Kiwix) + +A Biblioteca de Informações armazena versões compactadas de sites e referências que funcionam sem internet. + +**O que está incluído:** +- Wikipédia completa (milhões de artigos) +- Referências médicas e guias de primeiros socorros +- Guias práticos e informações de sobrevivência +- Livros clássicos do Projeto Gutenberg + +**Como usar:** +1. Clique em **Biblioteca de Informações** na tela inicial do Centro de Comando ou no [Depósito de Recursos](/supply-depot) +2. Escolha uma coleção (como a Wikipédia) +3. Pesquise ou navegue como no site normal + +--- + +### Plataforma Educacional — Cursos Offline (Kolibri) + +A Plataforma Educacional oferece cursos educacionais completos que funcionam offline. + +**O que está incluído:** +- Cursos em vídeo da Khan Academy +- Matemática, ciências, leitura e mais +- Acompanhamento de progresso para alunos +- Funciona para todas as idades + +**Como usar:** +1. Clique em **Plataforma Educacional** na tela inicial do Centro de Comando ou no [Depósito de Recursos](/supply-depot) +2. Entre ou crie uma conta de aluno +3. Navegue pelos cursos e comece a aprender + +**Dica:** O Kolibri suporta múltiplos usuários. Crie contas para cada membro da família para acompanhar o progresso individual. + +--- + +### Assistente de IA — Chat Integrado + +![Interface do Chat de IA](/docs/ai-chat.webp) + +O NOMAD inclui uma interface de chat de IA integrada, alimentada pelo Ollama. Ela roda inteiramente no seu servidor — sem necessidade de internet, sem dados enviados para lugar nenhum. + +**O que ela pode fazer:** +- Responder perguntas sobre qualquer assunto +- Explicar conceitos complexos de forma simples +- Ajudar com redação e edição +- Referenciar seus documentos enviados via Base de Conhecimento +- Gerar ideias e auxiliar na resolução de problemas + +**Como usar:** +1. Clique em **Chat de IA** no Centro de Comando ou vá em [Chat](/chat) +2. Digite sua pergunta ou solicitação +3. A IA responde em estilo conversacional + +**Dica:** Seja específico nas suas perguntas. Em vez de "me fale sobre plantas", tente "quais vegetais crescem bem na sombra?" + +**Nota:** O Assistente de IA precisa ser instalado primeiro. Ative-o durante a Configuração Fácil ou instale-o pelo [Depósito de Recursos](/supply-depot). + +**Aceleração por GPU:** Se seu servidor tem uma GPU NVIDIA, o instalador do NOMAD configura o suporte a GPU para você (ele instala o [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) e configura o Docker automaticamente). Você só precisa ter o driver NVIDIA presente no hospedeiro, que no Ubuntu você obtém habilitando "Instalar drivers de terceiros" durante a instalação. Com uma GPU, as respostas da IA são dramaticamente mais rápidas (melhoria de 10-20x). Se você adicionar uma GPU depois, vá ao [Depósito de Recursos](/supply-depot) e use **Forçar Reinstalação** no Assistente de IA para habilitá-lo. + +--- + +### Base de Conhecimento — IA com Reconhecimento de Documentos + +![Interface de envio da Base de Conhecimento](/docs/knowledge-base.webp) + +A Base de Conhecimento permite que você envie documentos para que a IA possa referenciá-los ao responder suas perguntas. Ela utiliza busca semântica (RAG via Qdrant) para encontrar informações relevantes nos seus arquivos enviados. + +**Tipos de arquivo suportados:** +- PDFs, arquivos de texto e outros formatos de documento +- A documentação do NOMAD é carregada automaticamente quando o Assistente de IA é instalado + +**Como usar:** +1. Vá em **[Base de Conhecimento →](/knowledge-base)** +2. Envie seus documentos (PDFs, arquivos de texto, etc.) +3. Os documentos são processados e indexados automaticamente +4. Faça perguntas no Chat de IA — a IA referenciará seus documentos enviados quando relevante +5. Remova documentos que não precisa mais — eles serão excluídos do índice e do armazenamento local + +**Casos de uso:** +- Envie planos de emergência para consulta rápida durante uma crise +- Carregue manuais técnicos e POPs para locais de trabalho offline +- Adicione guias curriculares para ensino domiciliar +- Armazene artigos de pesquisa para trabalho acadêmico + +--- + +### Mapas — Navegação Offline + +![Visualizador de mapas offline](/docs/maps.webp) + +Visualize mapas sem internet. Baixe as regiões necessárias antes de ficar offline. + +**Como usar:** +1. Clique em **Mapas** no Centro de Comando +2. Navegue arrastando e ampliando +3. Pesquise locais usando a barra de busca + +**Para adicionar mais regiões de mapa:** +1. Vá em **Configurações → Gerenciador de Mapas** +2. Selecione as regiões necessárias +3. Clique em Baixar + +**Dica:** Baixe mapas das áreas que você frequenta, além de regiões vizinhas por precaução. + +**[Abrir Mapas →](/maps)** + +--- + +## Gerenciando Seu Servidor + +### Adicionando Mais Conteúdo + +Conforme suas necessidades mudam, você pode adicionar mais conteúdo a qualquer momento: + +- **Mais aplicativos:** Configurações → Depósito de Recursos +- **Mais referências:** Configurações → Explorador de Conteúdo ou Gerenciador de Conteúdo +- **Mais regiões de mapa:** Configurações → Gerenciador de Mapas +- **Mais conteúdo educacional:** Pelo navegador de conteúdo integrado do Kolibri + +### Seletor de Wikipédia + +![Explorador de Conteúdo — navegue e baixe pacotes de Wikipédia e coleções curadas](/docs/content-explorer.webp) + +O NOMAD inclui uma ferramenta dedicada de gerenciamento de conteúdo da Wikipédia para navegar e baixar pacotes da Wikipédia. + +**Como usar:** +1. Vá em **[Explorador de Conteúdo →](/settings/zim/remote-explorer)** +2. Navegue pelos pacotes de Wikipédia disponíveis por idioma e tamanho +3. Selecione e baixe os pacotes desejados + +**Nota:** Selecionar um pacote de Wikipédia diferente substitui a versão baixada anteriormente. Apenas uma seleção de Wikipédia fica ativa por vez. + +### Benchmark do Sistema + +![Benchmark do Sistema com Pontuação NOMAD e Builder Tag](/docs/benchmark.webp) + +Teste o desempenho do seu hardware e veja como sua montagem NOMAD se compara com a comunidade. + +**Como usar:** +1. Vá em **[Benchmark do Sistema →](/settings/benchmark)** +2. Escolha um tipo de benchmark: Completo, Apenas Sistema ou Apenas IA +3. Veja sua Pontuação NOMAD (uma composição ponderada de desempenho de CPU, memória, disco e IA) +4. Crie uma Builder Tag (sua identidade temática NOMAD, como "Tactical-Llama-1234") +5. Compartilhe seus resultados no [ranking da comunidade](https://benchmark.projectnomad.us) + +**Nota:** Apenas Benchmarks Completos com dados de IA podem ser compartilhados no ranking da comunidade. + +### Mantendo Tudo Atualizado + +Enquanto você tiver internet, verifique atualizações periodicamente: + +1. Vá em **Configurações → Verificar Atualizações** +2. Se houver atualizações disponíveis, clique para instalar +3. Aguarde a conclusão da atualização (seu servidor será reiniciado) + +As atualizações de conteúdo (Wikipédia, mapas, etc.) podem ser gerenciadas separadamente das atualizações de software. + +**Atualizações automáticas:** O NOMAD também pode se manter atualizado sem que você precise verificar. Software, aplicativos instalados e conteúdo podem ser configurados para atualizar automaticamente de forma opcional, com verificações de segurança e uma janela de horário que você controla. Consulte o **[guia de Atualizações](/docs/updates)** para o panorama completo. + +**Canal de Acesso Antecipado:** Quer os recursos mais recentes antes de chegarem à versão estável? Habilite o Canal de Acesso Antecipado na página Verificar Atualizações para receber versões candidatas a lançamento. Você pode voltar ao canal estável a qualquer momento. + +### Monitorando a Saúde do Sistema + +Verifique seu servidor a qualquer momento: + +1. Vá em **Configurações → Sistema** +2. Veja o uso de CPU, memória e armazenamento +3. Verifique o tempo de atividade e o status do sistema + +--- + +## Dicas para Melhores Resultados + +### Antes de Ficar Offline + +- **Atualize tudo** — Execute atualizações de software e conteúdo +- **Baixe o que você precisa** — Mapas, referências, conteúdo educacional +- **Teste tudo** — Certifique-se de que os recursos funcionam enquanto você ainda tem internet para solucionar problemas + +### Gerenciamento de Armazenamento + +Seu servidor tem armazenamento limitado. Priorize: +- Conteúdo que você realmente vai usar +- Referências críticas (médicas, sobrevivência) +- Mapas da sua região +- Conteúdo educacional adequado às suas necessidades + +Verifique o uso de armazenamento em **Configurações → Sistema**. + +### Obtendo Ajuda + +- **Documentação do app:** Você está lendo agora +- **Assistente de IA:** Faça uma pergunta no [Chat de IA](/chat) +- **Notas de versão:** Veja as novidades de cada versão + +--- + +## Próximos Passos + +Você está pronto para usar o NOMAD! Aqui estão algumas coisas para experimentar: + +1. **Pesquise algo** — Busque um tópico na Biblioteca de Informações +2. **Aprenda algo** — Comece um curso da Khan Academy na Plataforma Educacional +3. **Faça uma pergunta** — Converse com a IA no [Chat de IA](/chat) +4. **Explore mapas** — Encontre seu bairro no visualizador de Mapas +5. **Envie um documento** — Adicione um PDF à [Base de Conhecimento](/knowledge-base) e pergunte à IA sobre ele + +Aproveite seu servidor de conhecimento offline!