Miniconda é a versão mini da Distribuição Anaconda com menos pacotes, mas poderosa o suficiente para configurar seus projetos de Python/R e ciência de dados. Miniconda inclui apenas ferramentas como ‘conda’, Python e pequenos pacotes adicionais úteis. É uma versão leve do Anaconda com um tamanho menor e ainda pode instalar pacotes adicionais através do repositório público do Anaconda ou de quaisquer repositórios de terceiros, como conda-forge e bioconda.

Este guia ensina como instalar o Miniconda em um servidor Linux Debian 12. Você aprenderá a usar a linha de comando ‘conda’ para criar e gerenciar ambientes virtuais e pacotes. Por fim, também mostraremos como usar o Miniconda para desenvolvimento Flask, que é isolado do ambiente virtual.

Pré-requisitos

Para começar com este guia, certifique-se de ter o seguinte:

• Um servidor/desktop Linux - este exemplo usa Debian 12
• Um usuário não-root com privilégios de administrador

Instalando Miniconda

Para instalar o Miniconda no Debian, você pode facilmente baixar o instalador com ‘curl’ e executá-lo a partir do terminal. Aqui está como instalar o Miniconda na sua máquina Debian.

Baixe o instalador do Miniconda para Linux com o comando ‘curl’ abaixo.

curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

Uma vez que o download esteja completo, execute o script do instalador ‘Miniconda3-latest-Linux-x86_64’ como o seguinte:

bash ~/Miniconda3-latest-Linux-x86_64.sh

Agora faça o seguinte:

• Pressione e segure ENTER para revisar o contrato de licença.
• Digite ‘yes’ para concordar com o contrato de licença.
• Pressione ENTER para configurar o caminho de instalação padrão para ‘ /home/USER/miniconda3 ‘.
• Para o processo de inicialização, selecione ‘yes’ para automatizar a inicialização do Miniconda.
• Após o processo ser concluído, você verá uma mensagem como ‘ Obrigado por instalar o miniconda3 ‘.

Agora que a instalação está concluída, recarregue seu ambiente de shell atual com o comando abaixo. Abaixo você pode usar um, o ‘~/.bashrc’ para usuários Bash ou ‘~/.zshrc’ para usuários ZSH.

source ~/.bashrc  
source ~/.zshrc

Depois que seu shell for recarregado, você entrará automaticamente no ambiente ‘ (base) ‘, que é apenas para o Miniconda.

Para seus aplicativos ou projetos, crie seu próprio ambiente, que você aprenderá mais tarde.

Verifique a versão do ‘conda’ com o comando abaixo. Neste momento, temos o conda ‘ 24.11.1 ‘ instalado.

conda --version

Por fim, você pode verificar informações detalhadas sobre a instalação do Miniconda com o seguinte:

conda info

Aqui, você pode ver o ambiente ativo, diretório de dados, diretório de cache, versão de ‘ conda ‘, diretórios de ambiente e URLs de canal (repositórios).

Criando Ambiente com conda

Depois de instalar o Miniconda, vamos aprender como criar e gerenciar ambientes virtuais usando o Miniconda.

O Miniconda fornece uma ferramenta de linha de comando ‘conda’ para gerenciar e implantar ambientes virtuais, pacotes e aplicativos. Nesta etapa, você aprenderá como criar e ativar ambientes virtuais com ‘conda’, e também instalar pacotes em seu ambiente virtual.

Para criar um novo ambiente de desenvolvimento Conda, execute o comando ‘ conda ‘ abaixo. Neste exemplo, você criará um novo ambiente chamado ‘ cenv ‘.

conda create -n cenv

Quando solicitado, insira ‘ y ‘ para prosseguir.

Uma vez que o ambiente ‘ cenv ‘ é criado, execute o comando ‘ conda activate ‘ abaixo para ativar seu novo ambiente.

conda activate cenv

Com isso, seu shell deve mudar de ‘ (base) ‘ para ‘ (cenv) ‘.

Em seguida, execute o comando ‘conda install’ abaixo para instalar seus pacotes. Por exemplo, aqui vamos instalar os pacotes Python 3.12, Beautifulsoup4 e docutils.

conda install python=3.12 beautifulsoup4 docutils

Por fim, você pode desativar seu ambiente atual com o comando abaixo.

conda deactivate

Além disso, você também pode usar o comando de linha única ‘conda create’ para criar um novo ambiente e instalar pacotes como o seguinte.

conda create cent python=3.12 beautifulsoup4 docutils

Criando Ambiente com arquivo YAML

O Miniconda também fornece uma maneira de criar ambientes através do arquivo YAML. Com isso, você pode facilmente compartilhar o arquivo YAML com seus amigos e todos terão os mesmos ambientes. Agora vamos aprender como criar ambientes virtuais com ‘conda’ através do arquivo YAML.

Crie um novo arquivo ‘ environment.yml ‘ com seu editor de texto. Neste caso, usaremos ‘ nano ‘.

nano environment.yml

Insira a configuração abaixo para criar um novo ambiente ‘ myproject ‘ com pacotes ‘ Python3.12 ‘, ‘ pip ‘ e ‘ flask ‘. Esse pacote será instalado automaticamente.

name: myproject  
dependencies:  
 - python=3.12  
 - pip  
 - flask

Salve o arquivo e saia do editor quando terminar.

Agora execute o comando ‘ conda env create ‘ abaixo para criar um novo ambiente virtual através do arquivo ‘ environment.yml ‘.

conda env create -f environment.yml

Uma vez completo, ative o ambiente ‘ myproject ‘ com o comando abaixo.

conda activate myproject

Se tudo correr bem, seu shell se tornará como ‘ (myproject) user@host’ como na captura de tela abaixo.

Listando Ambientes e Pacotes

Nesta seção, você aprenderá como verificar os ambientes que você criou e listar os pacotes disponíveis que você instalou usando ‘conda’.

Execute o comando ‘conda env’ abaixo para listar projetos/ambientes em seu sistema. Assim, neste caso, você verá três ambientes, ‘ (base) ‘ para o Miniconda padrão, ‘ cenv ‘ e ‘ myproject ‘.

conda env list

Você também pode verificar a lista de pacotes dentro do seu ambiente usando o comando ‘ conda list ‘ abaixo.

conda list -n myproject  
conda list -n cenv

Abaixo você pode ver a lista de pacotes dentro do ‘ myproject ‘.

Removendo Pacotes e Ambiente

Agora que você aprendeu como listar ambientes e pacotes, o próximo passo que você aprenderá é como remover pacotes e ambientes virtuais dentro do Miniconda.

Para remover um pacote específico do seu ambiente, execute o comando ‘ conda remove ‘ seguido de ‘ -n env-name ‘ e o nome do pacote.

conda remove -n myproject pip

Para remover o ambiente do seu sistema, execute o seguinte comando ‘ conda remove ‘ seguido pelo nome do seu ambiente e a opção ‘ –all ‘.

conda remove -n myproject --all

Por fim, verifique novamente sua lista de ambientes com o comando abaixo. Você verá que seu ambiente foi excluído. Neste exemplo, o ‘ myproject ‘ foi excluído.

conda env list

Instalando Flask com Conda

Para este último passo, daremos uma demonstração do desenvolvimento Flask usando o Miniconda. Para isso, usaremos o ambiente ‘cenv’ que criamos e, em seguida, instalaremos os pacotes Python, Pip e Flask.

Primeiro, ative o ambiente virtual ‘ cenv ‘ e instale os pacotes necessários, incluindo ‘ flask ‘.

conda activate cenv  
conda install python=3.12 pip flask

Agora crie um novo diretório de projeto ‘ ~/flask ‘ e entre nele. Em seguida, crie um novo aplicativo ‘ myapp.py ‘ usando seu editor de texto preferido.

mkdir -p ~/flask; cd ~/flask  
vim myapp.py

Insira o seguinte script Python para criar um novo aplicativo ‘ myapp ‘ que mostrará seu ‘ Hello Flask ‘ no seu navegador.

#myapp  
from flask import Flask, render_template # importando a função render_template  
  
app = Flask(__name__)  
# rota para a página inicial  
@app.route("/")  
def hello():  
return render_template('index.html')  
  
if __name__ == ' __main__':  
app.run(debug=True)

Agora crie um novo diretório ‘templates’ e crie um arquivo ‘index.html’ dentro desse diretório.

mkdir -p templates  
nano templates/index.html

Insira o seguinte script HTML que será renderizado pela função ‘ render_template ‘.

  
   
 
Hello Flask dentro do Miniconda!
  
   

Em seguida, execute o comando ‘flask’ abaixo para iniciar seu aplicativo. Isso executará o Flask na porta padrão ‘5000’.

flask --app myapp run

Ao executar, você verá uma saída como a seguinte:

Por fim, abra uma nova aba do terminal e conecte-se ao seu servidor. E então, execute o comando ‘curl’ abaixo para acessar seu aplicativo Flask.

curl http://localhost:5000/

Você verá o script ‘index.html’ exibido no seu terminal.

Conclusão

Parabéns! Você aprendeu como instalar e usar o Miniconda. Você aprendeu como criar, gerenciar, listar e excluir ambientes com a utilidade ‘conda’. Você também aprendeu como configurar o projeto Python Flask dentro do ambiente ‘conda’. A partir daqui, você pode criar vários ambientes para seus projetos ou pode criar um script YAML para ambientes Miniconda e distribuí-lo com seus colegas de trabalho. Isso nos permite ter o mesmo ambiente de desenvolvimento para a equipe.