Skip to content

ASReview LAB — Guia de Instalação no Linux Mint

Versão de referência: ASReview LAB 3.x (versão atual: 3.0.5) Sistema: Linux Mint 21.x ou 22.x (base Ubuntu Jammy/Noble) Última atualização: maio/2026 Fonte oficial: https://asreview.readthedocs.io

O que é o ASReview LAB?

ASReview LAB é uma ferramenta de código aberto que aplica Active Learning para triagem eficiente de literatura científica em revisões sistemáticas. Publicada na Nature Machine Intelligence (van de Schoot et al., 2021), ela aprende com suas decisões de inclusão/exclusão e prioriza automaticamente os artigos mais relevantes — reduzindo drasticamente o tempo de triagem.

Referência obrigatória:

VAN DE SCHOOT, R. et al. An open source machine learning framework for efficient and transparent systematic reviews. Nature Machine Intelligence, v. 3, p. 125–133, 2021. https://doi.org/10.1038/s42256-020-00287-7

Pré-requisitos

Python 3.10 ou superior

O Linux Mint 22.x (Noble) já vem com Python 3.12. Verifique:

python3 --version

Se a versão for inferior a 3.10, instale via deadsnakes PPA:

sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.12 python3.12-venv python3.12-dev

pip

⚠️ Não execute pip install diretamente no terminal no Linux Mint 22+. O sistema operacional bloqueia instalações fora de um ambiente virtual com o erro externally-managed-environment. Isso é um comportamento intencional do Debian/Ubuntu moderno para proteger os pacotes do sistema. Todo o uso do pip deve ser feito dentro do ambiente virtual (ver seção abaixo).

Instalação

Método 1 — Ambiente virtual (recomendado)

Usar um ambiente virtual evita conflitos com outros pacotes Python do sistema.

1. Criar o ambiente virtual:

python3 -m venv ~/envs/asreview

2. Ativar o ambiente:

source ~/envs/asreview/bin/activate

O prompt do terminal ficará com o prefixo (asreview) indicando que o ambiente está ativo.

3. Atualizar o pip dentro do ambiente:

pip install --upgrade pip

4. Instalar o ASReview LAB:

pip install asreview

5. Verificar a instalação:

asreview --version

6. Iniciar o ASReview LAB:

asreview lab

O navegador abrirá automaticamente em http://localhost:5000. Mantenha o terminal aberto — ele é o motor do ASReview.

Método 2 — Instalação global com pipx (alternativa limpa)

O pipx instala aplicativos Python em ambientes isolados automaticamente, sem necessidade de ativar manualmente.

sudo apt install -y pipx
pipx ensurepath
pipx install asreview

Reinicie o terminal e use:

asreview lab

Método 3 — Docker (para uso em servidor ou ambiente isolado)

docker run -p 5000:5000 ghcr.io/asreview/asreview lab

Para persistir os projetos localmente:

docker run -p 5000:5000 \
  -v ~/asreview-projetos:/project_folder \
  ghcr.io/asreview/asreview lab

Acesse: http://localhost:5000

Atualização

Para atualizar para a versão mais recente (com ambiente virtual ativado):

source ~/envs/asreview/bin/activate
pip install --upgrade asreview

Desinstalação

A desinstalação não apaga seus projetos. Os dados ficam em ~/.asreview/.

source ~/envs/asreview/bin/activate
pip uninstall asreview

Para remover os dados de projetos também:

rm -rf ~/.asreview/

Alias de conveniência (opcional)

Para não ter que ativar o ambiente toda vez, adicione um alias ao ~/.bashrc:

echo 'alias asreview="source ~/envs/asreview/bin/activate && asreview"' >> ~/.bashrc
source ~/.bashrc

Depois basta digitar asreview lab diretamente.

Fluxo básico de uso

  1. Importe seus dados: formatos aceitos: CSV, RIS, XLSX, TSV
  2. Crie um projeto: dê um nome e configure o modelo de IA
  3. Prior knowledge (opcional): informe artigos que você já sabe que são relevantes ou irrelevantes — acelera o aprendizado
  4. Triagem: classifique os artigos como Relevante ou Não Relevante; o modelo aprende e reordena a fila
  5. Acompanhe o progresso: o dashboard mostra a curva de recall estimada
  6. Exporte: baixe os resultados em CSV ou RIS

Extensões úteis

Extensão Função Instalação
asreview-makita Gerador de workflows para estudos de simulação pip install asreview-makita
asreview-wordcloud Visualização em nuvem de palavras pip install asreview-wordcloud
asreview-datatools Deduplicação, conversão e composição de datasets pip install asreview-datatools

Solução de problemas

externally-managed-environment

O Linux Mint 22+ bloqueia instalações diretas com pip fora de um ambiente virtual. Solução: use sempre o ambiente virtual (Método 1) ou pipx (Método 2). Nunca use --break-system-packages para o ASReview, pois pode causar conflitos com outros pacotes.

Porta 5000 em uso

Se a porta 5000 estiver ocupada:

asreview lab --port 5001

Abra manualmente: http://localhost:5000

Erro de permissão no Docker

sudo usermod -aG docker $USER
# Faça logout e login novamente

Localização dos dados de projetos

Todos os projetos ficam salvos em:

~/.asreview/

Faça backup desta pasta regularmente para não perder revisões em andamento.

Referências

  • Documentação oficial: https://asreview.readthedocs.io
  • Repositório GitHub: https://github.com/asreview/asreview
  • PyPI: https://pypi.org/project/asreview/
  • VAN DE SCHOOT, R. et al. Nature Machine Intelligence, 3, 125–133, 2021.