pip install falhando: os cinco motivos de sempre

É a barreira número um de quem está começando — e quase nunca é um problema só. Abaixo, as cinco causas em ordem de frequência, com o conserto de cada uma.

1. “pip não é reconhecido”

O Python foi instalado sem marcar a opção de adicionar ao PATH. Não precisa reinstalar — chame o pip através do próprio Python:

python -m pip install nome-do-pacote

# Windows, se 'python' também não for reconhecido:
py -m pip install nome-do-pacote

2. Permissão negada

Você está tentando escrever na instalação do sistema. A solução não é rodar como administrador (isso bagunça o Python do sistema e cria problema pior lá na frente). Use um ambiente seu:

python -m venv .venv
.venv\Scripts\activate        # Windows
source .venv/bin/activate     # Linux / macOS
pip install nome-do-pacote

3. “subprocess-exited-with-error” / erro de compilação

O pacote precisa ser compilado e falta compilador na máquina. Duas saídas, na ordem: atualize as ferramentas de instalação (muitas vezes resolve, porque passa a baixar um pacote pronto em vez de compilar), e só então instale o compilador.

python -m pip install --upgrade pip setuptools wheel

Se for o ta-lib, o caso é específico e está nesta página.

4. Instalou, mas o import falha

Instalou num Python e está rodando noutro. Confirme que os dois são o mesmo:

python -c "import sys; print(sys.executable)"
python -m pip --version

Os dois caminhos têm que apontar para a mesma pasta.

5. Instalando direto do repositório

Muita biblioteca de corretora não está publicada no repositório oficial de pacotes — só no código-fonte. Nesse caso é preciso ter o git instalado:

pip install git+https://github.com/usuario/repositorio.git