Platform For AI:Gerencie bibliotecas de terceiros

# Install in Python 3 (default)
pip install <yourLibraryName>

# Install in Python 2
source activate python2
pip install <yourLibraryName>

# Install in TensorFlow 2.0
source activate tf2
pip install <yourLibraryName>

!pip install bottle

Importância do ambiente correto

O Terminal e o Jupyter Notebook podem usar ambientes Python diferentes. Se você instalar uma biblioteca no Terminal, mas não conseguir importá-la no notebook, execute which python no Terminal e !which python em uma célula do notebook para comparar os caminhos. Se forem diferentes, instale a biblioteca diretamente na célula do notebook usando !pip install.

pip list

pip uninstall <yourLibraryName>

pip install --upgrade numpy==<versionNumber>

Visualizar o mirror atual do pip

pip config list

O valor de global.index-url indica a URL do mirror ativo. Exemplo de saída:

global.index-url='https://mirrors.aliyun.com/pypi/simple/'
global.trusted-host='mirrors.aliyun.com'
install.trusted-host='mirrors.aliyun.com'

Usar um mirror diferente para uma única instalação

Use o parâmetro -i para substituir o mirror em uma instalação específica:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <yourLibraryName>

# If an SSL authentication error occurs, add --trusted-host:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn <yourLibraryName>

Alterar o mirror global do pip

Edite o arquivo ~/.config/pip/pip.conf:

vim ~/.config/pip/pip.conf

Para usar o mirror da Universidade Tsinghua, defina index-url e trusted-host:

[global]
trusted-host=pypi.tuna.tsinghua.edu.cn
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/

[install]
trusted-host=pypi.tuna.tsinghua.edu.cn

Os pacotes instalados via pip são perdidos após reiniciar a instância?

Não. O DSW preserva todos os dados do disco da instância — incluindo ambientes em /mnt/workspace e /root — quando a instância usa um disco em nuvem como disco do sistema. Os pacotes instalados continuam disponíveis após a reinicialização.

Exceção: A exclusão permanente da instância apaga todos os dados.

Por que o import falha após instalar uma biblioteca com pip?

Reinicie primeiro o kernel do Jupyter. Se o erro persistir, provavelmente o Terminal e o notebook estão usando ambientes Python diferentes. Execute which python no Terminal e !which python em uma célula do notebook para confirmar. Se os caminhos forem distintos, instale a biblioteca diretamente no notebook:

!pip install <yourLibraryName>

Como alternativa, ative o ambiente correto no Terminal antes de instalar:

# Install in Python 2
source activate python2
pip install --user <yourLibraryName>

# Install in TensorFlow 2.0
source activate tf2
pip install --user <yourLibraryName>

Como resolver conflitos de dependência ou erros de versão durante o pip install?

Siga estas etapas na ordem apresentada:

1. Troque a imagem do DSW (recomendado). Pare a instância e crie uma nova com uma imagem que atenda aos requisitos da biblioteca. Por exemplo, se um pacote falhar na imagem PyTorch 2.1, tente a PyTorch 2.3 ou uma imagem da série ModelScope, que geralmente oferecem melhor compatibilidade.

2. Instale uma versão específica. Consulte a documentação da biblioteca para encontrar uma versão compatível com as versões de Python e CUDA do ambiente:

   pip install package_name==x.y.z

3. Teste outro mirror do pip. Problemas de rede com o mirror padrão podem causar falhas:

   pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <yourLibraryName>

Como corrigir o erro "CUDA driver version is too low"?

Não tente atualizar manualmente o driver NVIDIA ou o CUDA Toolkit. As versões do driver e do CUDA em uma instância DSW são pré-configuradas e não podem ser alteradas — modificações manuais corrompem a instância e causam perda de dados.

A solução correta é parar a instância atual e criar uma nova usando uma imagem oficial do DSW com a versão necessária do CUDA. A tag da imagem indica a versão do CUDA — por exemplo, modelscope:1.9.4-pytorch2.0.1tensorflow2.13.0-gpu-py38-cu118-ubuntu20.04 inclui CUDA 11.8 (cu118).

O que fazer quando o pip install trava ou atinge o tempo limite?

Isso quase sempre indica um problema de rede. Siga as etapas abaixo:

Etapa 1: Verificar a conectividade de rede

ping www.aliyun.com

Se o comando falhar, o gateway pode estar mal configurado.

Etapa 2: Verificar a configuração do gateway

Na configuração da instância DSW, verifique o Internet Access Gateway:

• Public Gateway: Opção padrão. Fornece acesso à internet com largura de banda limitada, o que pode causar tempos limite em downloads grandes.

• Dedicated Gateway: Oferece acesso à rede mais rápido, mas exige configuração manual — crie um gateway NAT de Internet na Virtual Private Cloud (VPC), vincule endereços Elastic IP (EIPs) e configure regras SNAT. Para instruções de configuração, consulte Melhorar a velocidade de acesso à rede pública com um gateway dedicado.

Etapa 3: Mudar para um mirror pip mais rápido

# Tsinghua mirror (recommended)
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn <yourLibraryName>

# USTC mirror
pip install -i https://pypi.mirrors.ustc.edu.cn/simple --trusted-host pypi.mirrors.ustc.edu.cn <yourLibraryName>

# Douban mirror
pip install -i https://pypi.doubanio.com/simple --trusted-host pypi.doubanio.com <yourLibraryName>

Para tornar a alteração do mirror permanente, consulte Alterar o mirror global do pip.

Etapa 4: Instalar offline

Se a rede estiver indisponível, instale a partir de um arquivo wheel local:

1. Em uma máquina com acesso à internet, baixe o arquivo wheel:

   pip download <yourLibraryName> -d ./packages

2. Faça upload do arquivo .whl para a instância DSW. Consulte Upload e download de arquivos.

3. Instale a partir do arquivo enviado:

   pip install /path/to/your-package.whl

Como extrair arquivos .zip ou .7z se unzip ou 7z não for encontrado?

Instale as ferramentas usando apt-get no Terminal:

• Para arquivos .zip:

  apt-get update && apt-get install -y unzip
  unzip your_file.zip

• Para arquivos .7z:

  apt-get update && apt-get install -y p7zip-full
  7z x your_file.7z

Como obter permissões de root no terminal do WebIDE?

A maioria das imagens oficiais do DSW fornece um shell root por padrão. Verifique se o prompt do terminal exibe root@.... Ignore o aviso "pip running as root" com segurança.

Se a imagem não fornecer acesso root, crie uma nova instância usando uma imagem que ofereça esse recurso.

Posso executar comandos Docker dentro de uma instância DSW?

Depende do tipo de recurso. Para recursos Lingjun, abra um ticket para ser adicionado à lista de permissões. Para todos os outros tipos de instância DSW, não há suporte para Docker.

Posso iniciar um servidor X ou executar aplicativos GUI em uma instância DSW?

Não. As instâncias DSW não suportam servidor X nem aplicativos GUI.

Para usar o Miniconda no gerenciamento de ambientes e pacotes Python, siga estas etapas.

1. Baixe e instale. Abra o Terminal e execute:

   wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
   bash Miniconda3-latest-Linux-x86_64.sh -b -p /root/miniconda3
   /root/miniconda3/bin/conda init

2. Pare e reinicie a instância DSW. Após a reinicialização, o ambiente Python do conda estará disponível. Verifique o ambiente Python ativo:

   # If running in Terminal
   which python
   
   # If running in Notebook cell
   !which python

3. Se o ambiente Python do conda ainda não estiver disponível no Terminal, modifique o PATH em .bashrc:

   1. No Terminal, execute cd /root/ para acessar o diretório do arquivo .bashrc.

   2. Use o vim para editar .bashrc. Adicione export PATH="/root/miniconda3/bin:$PATH" no início do arquivo, salve e saia.

      

   3. No Terminal, execute source .bashrc para aplicar a configuração.

   4. Execute which python novamente para verificar o ambiente Python ativo.