Ir para o conteúdo

Tutorial: Instalação e Primeiro Uso

Neste tutorial você vai instalar o Anotae, criar seu vault cifrado e configurar o essencial para começar a usar no dia a dia. Ao final, terá o programa rodando, seu perfil preenchido e o backup automático ativado — pronto para o primeiro atendimento.

Tempo estimado: 15 a 20 minutos.

Pré-requisitos

Antes de começar, verifique se seu computador atende aos requisitos mínimos:

Requisito Mínimo Recomendado
Sistema operacional Windows 10 (64-bit) / macOS 12 / Ubuntu 20.04 Windows 11 / macOS 14 / Ubuntu 22.04
RAM 4 GB 8 GB
Espaço em disco 2 GB livres 5 GB livres
Conexão com internet Apenas para o download inicial —

Nota sobre IA local: os módulos opcionais de IA (LLM e transcrição de voz) exigem 8 GB de RAM e mais 4 GB de espaço adicional para os modelos. Eles não são necessários para o uso básico e podem ser instalados depois.

Passo 1: Baixar o instalador

Acesse a página de releases do projeto no GitHub:

https://github.com/anotae-app/anotae/releases/latest

Na seção Assets, baixe o arquivo correspondente ao seu sistema:

  • Windows: anotae-vX.Y.Z-windows-x64.msi
  • macOS (Apple Silicon): anotae-vX.Y.Z-macos-arm64.dmg
  • macOS (Intel): anotae-vX.Y.Z-macos-x64.dmg
  • Linux: anotae-vX.Y.Z-linux-x86_64.AppImage

Baixe também o arquivo SHA256SUMS.txt que fica logo abaixo dos instaladores.

Verificar a integridade do arquivo (obrigatório)

Antes de instalar, confirme que o arquivo não foi corrompido ou adulterado durante o download.

Windows (PowerShell):

certutil -hashfile anotae-vX.Y.Z-windows-x64.msi SHA256

Compare o hash exibido com o valor correspondente em SHA256SUMS.txt. Eles devem ser idênticos, caractere por caractere.

macOS (Terminal):

shasum -a 256 anotae-vX.Y.Z-macos-arm64.dmg

Linux (Terminal):

sha256sum anotae-vX.Y.Z-linux-x86_64.AppImage

Dica de segurança: se os hashes não coincidirem, não instale o arquivo. Isso indica download corrompido ou, em casos raros, arquivo substituído. Tente baixar novamente de outra rede ou entre em contato pelo repositório do projeto.

Passo 2: Instalar o Anotae

Windows

  1. Dê duplo clique no arquivo .msi baixado.
  2. Se o Windows SmartScreen exibir um aviso ("Windows protegeu seu computador"), clique em Mais informações → Executar assim mesmo. Isso acontece porque o instalador é assinado com attestation Sigstore (open-source), não com um certificado Authenticode pago.
  3. Siga o assistente de instalação: aceite a licença (AGPL-3.0), escolha a pasta de instalação (o padrão C:\Program Files\Anotae funciona bem) e clique em Instalar.
  4. Ao final, deixe marcada a opção "Iniciar Anotae" e clique em Concluir.

macOS

  1. Dê duplo clique no arquivo .dmg para montá-lo.
  2. Na janela que abre, arraste o ícone do Anotae para a pasta Aplicativos.
  3. Na primeira abertura (clique duplo em Aplicativos → Anotae), o macOS pode exibir: "Anotae não pode ser aberto porque é de um desenvolvedor não identificado."
  4. Abra Preferências do Sistema → Privacidade e Segurança
  5. Role até a mensagem sobre Anotae e clique em Abrir Assim Mesmo
  6. O Anotae abre normalmente a partir daí.

Linux (AppImage)

  1. Abra o terminal na pasta onde baixou o arquivo e torne-o executável:
chmod +x anotae-vX.Y.Z-linux-x86_64.AppImage
  1. Execute diretamente:
./anotae-vX.Y.Z-linux-x86_64.AppImage
  1. Opcional — integrar ao menu de aplicativos: use a ferramenta AppImageLauncher (disponível nos repositórios da maioria das distros) para que o Anotae apareça no launcher do seu ambiente gráfico.

Ubuntu/Debian: se o AppImage não abrir, instale a dependência FUSE: sudo apt install libfuse2

Passo 3: Wizard de boas-vindas — escolher a pasta do vault

Na primeira abertura, o Wizard de Boas-vindas aparece automaticamente.

A primeira tela pergunta onde você quer guardar seu vault (o banco de dados cifrado com seus atendimentos).

Opções comuns:

  • Pasta padrão (recomendado para começar): o Anotae sugere Documentos/Anotae/vault.db — clique em Usar esta pasta para aceitar.
  • Pasta personalizada: clique em Escolher outra pasta se quiser guardar em um HD externo, pen drive cifrado ou diretório específico.

Dica: se você usa um serviço de sync de arquivos (Dropbox, Google Drive, OneDrive), não coloque o vault dentro da pasta sincronizada. O vault é um arquivo SQLite binário — sync em tempo real pode corrompê-lo. Use o backup automático do Anotae (configurado no Passo 7) para manter cópias seguras.

Clique em Próximo para continuar.

Passo 4: Criar a senha-mestra

Esta é a etapa mais importante da instalação. A senha-mestra protege todos os seus atendimentos com criptografia forte (Argon2id + ChaCha20-Poly1305).

O que acontece quando você cria a senha

  1. O Anotae executa automaticamente um benchmark de hardware — uma barra de progresso exibe "Testando parâmetros de segurança para o seu hardware...". Isso leva de 2 a 8 segundos e acontece apenas uma vez.

  2. O benchmark ajusta os parâmetros do Argon2id para que derivar a chave leve aproximadamente 1 segundo no seu hardware — forte o suficiente para resistir a ataques, rápido o suficiente para não incomodar no dia a dia.

  3. Você digita e confirma a senha. O Anotae exibe um medidor de força da senha em tempo real.

Escolher uma boa senha-mestra

  • Mínimo recomendado: 12 caracteres
  • Ideal: frase de 4+ palavras comuns separadas por espaço ou símbolo (ex.: farinha-telhado-girafa-2026) — fácil de lembrar, difícil de quebrar
  • Evite: datas de aniversário, nomes de filhos, sequências de teclado

Dica de segurança: a senha-mestra não tem mecanismo de recuperação. Se você esquecê-la, não há forma de acessar os dados do vault — nem nós, nem ninguém. Anote-a em um local físico seguro (papel guardado em lugar reservado, gerenciador de senhas offline como KeePassXC). Isso é intencional: garante que só você acessa seus dados.

Digite a senha, confirme no segundo campo e clique em Criar vault.

Passo 5: Preencher "Meu Perfil"

Após criar o vault, o wizard oferece a opção de preencher seu perfil profissional. Isso é opcional agora, mas recomendado: o perfil pré-preenche o cabeçalho de cada atendimento automaticamente.

Clique em Preencher agora (ou acesse depois via Ctrl+M).

Preencha os campos:

Campo Exemplo
Nome profissional Como deve aparecer nos documentos
CNS Profissional Seu número CNS de 15 dígitos
Função / CBO MFC, PED, ENF, PSI, ACS, etc.
CNES da unidade Código da UBS ou serviço onde atua
Conselho e registro CRM, COREN, CRO, CRP, etc.

Dica: você pode ter mais de um perfil — útil se atua em duas unidades diferentes. Use Ctrl+M → Adicionar perfil para criar um segundo.

Clique em Salvar perfil e depois em Próximo.

Passo 6: Fazer o primeiro atendimento

O wizard oferece atalho direto: "Registrar meu primeiro atendimento".

Clique para seguir para o editor — ou, se preferir ler o passo a passo detalhado com exemplo clínico completo (HAS, SOAP, CIAP-2, CID-10, SIGTAP), consulte o tutorial:

→ Seu Primeiro Atendimento

Passo 7: Configurar backup automático

Com o vault criado e o primeiro atendimento salvo, configure o backup automático para proteger seus dados.

Pressione Ctrl+B (ou clique em Vault → Backups na barra de menu).

Na tela de Backups:

  1. Clique em Configurar backup automático.

  2. Pasta de destino: escolha um local diferente do vault principal. Exemplos recomendados:

  3. Um HD externo ou pen drive
  4. Uma pasta em outro volume do sistema

  5. Uma pasta sincronizada com serviço de nuvem (o arquivo de backup é cifrado, então sync é seguro neste caso)

  6. Retenção: selecione por quanto tempo manter backups antigos. A sugestão padrão é 30 dias — suficiente para recuperar atendimentos de um mês atrás se necessário.

  7. Frequência: selecione Diário (recomendado) ou A cada 6 horas para maior proteção.

  8. Clique em Ativar backup automático.

O Anotae vai criar o primeiro backup imediatamente e exibir a confirmação. A partir daí, backups automáticos rodam silenciosamente em segundo plano.

Verificar um backup: na lista de backups, clique em qualquer entrada e depois em Verificar integridade. O Anotae confere o hash SHA-256 e confirma que o arquivo não foi corrompido.

Resultado

Ao concluir este tutorial, você tem:

  • Anotae instalado e com hash SHA-256 verificado
  • Vault cifrado com sua senha-mestra (Argon2id + ChaCha20-Poly1305)
  • Perfil profissional preenchido (CNS, CNES, função)
  • Backup automático diário configurado com retenção de 30 dias

Próximos passos

  • Registrar atendimentos: siga o tutorial Seu Primeiro Atendimento para aprender a preencher a nota SOAP com codificações CIAP-2 e CID-10.

  • Injetar dados no e-SUS automaticamente: instale a extensão de navegador com o comando:

anotae install-extension --browser chrome

Depois siga o guia Configurar extensão de navegador.

  • Enviar fotos do celular: use o canal mobile — em Ferramentas → Canal Mobile aparece um QR code; escaneie com o celular para enviar imagens (exames, ECG em papel) diretamente para o atendimento aberto.

  • Verificar a versão instalada:

anotae version