Instalação

Tip

Esta página pressupõe que você se sente confortável usando um terminal e se dispõe a aprender como usar um gerenciador de pacotes. Se você é um iniciante e só quer iniciar o com SciPy o mais rápido possível, confira o guia de instalação para iniciantes!

O método recomendado para instalar a SciPy depende do seu fluxo de trabalho preferido. Os fluxos de trabalho comuns podem ser divididos nas seguintes categorias:

Para instalar a SciPy com stubs para tipagem estática, veja Instalando com stubs para tipagem.

Tip

A instalação de tipos sub pode ser necessário para Ambientes de Desenvolvimento Interativo (IDEs) para fornecer dicas de tipo precisas.

Instalando com uv#

Aqui está um guia passo-a-passo para criar um projeto para usar a SciPy, com uv, um gerenciador de pacotes Python.

  1. Instale uv seguindo as instruções na documentação do uv.

  2. Criar um novo projeto em um novo subdiretório, executando o seguinte em um terminal:

uv init try-scipy
cd try-scipy
Hint

O segundo comando muda o diretório para dentro do diretório do seu projeto.

  1. Criar um novo projeto em um novo subdiretório, executando o seguinte em um terminal:
uv add scipy
Note

Isto irá instalar o Python automaticamente se você ainda não o tiver instalado!

Tip

Você pode instalar outras bibliotecas de Python da mesma forma, por exemplo

uv add matplotlib

  1. Experimente a SciPy!
uv run python

This will launch a Python interpreter session, from which you can import scipy.

Para as próximas etapas, consulte o guia do usuário SciPy.

Note

Depois de reiniciar o computador, você deve navegar até o diretório do seu projeto try-scipy e executar uv run python para entrar novamente em uma sessão do interpretador Python com a SciPy disponível para ser importada. Para executar um script Python, você pode usar uv run myscript.py.

Leia mais no guia uv para trabalhar em projetos.

Instalando com pixi#

Se você trabalha com pacotes que não sejam Python puro, você pode preferir instalar o pacote SciPy com o Conda, para que você possa usar o mesmo fluxo de trabalho para pacotes que não estão disponíveis no PyPI, o Python Package Index. Conda pode gerenciar pacotes em qualquer linguagem, então você pode usá-lo para instalar o próprio Python, compiladores e outras linguagens.

Os passos para instalar SciPy a partir do conda-forge usando a ferramenta de gerenciamento de pacotes pixi são muito semelhantes aos passos para o uv:

  1. Instale o pixi, seguindo as instruções na documentação do pixi.
  1. Crie um novo projeto em um novo subdiretório:
pixi init try-scipy
cd try-scipy
  1. Adicionar a SciPy ao seu projeto:
pixi add scipy
  1. Experimente a SciPy!
pixi run python

Em fluxos de trabalho baseados em projetos, um projeto é um diretório que contém um arquivo manifesto descrevendo o projeto, um arquivo lock-file descrevendo as dependências exatas do projeto, e os (potencialmente vários) ambientes do projeto.

Em contrapartida, em fluxos de trabalho baseados em ambientes você instala pacotes em um ambiente, que você pode ativar e desativar de qualquer diretório. Estes fluxos de trabalho são bem estabelecidos, mas não possuem alguns benefícios de fluxos de trabalho baseados em projetos.

Instalando com pip#

  1. Instale o Python.

  2. Crie e ative um ambiente virtual com o venv.

  1. Instale a SciPy, usando pip:
python -m pip install scipy

Instalando com conda#

O miniforge é a ferramenta recomendada para instalar o conda e o mamba, dois gerenciadores de ambientes virtuais baseados em Conda. Depois de criar um ambiente, você pode instalar a SciPy a partir do conda-forge da seguinte forma:

conda install scipy # ou
mamba install scipy

Instalando com os stubs de tipagem#

Os gerenciadores de pacotes do sistema operacional podem instalar os pacotes Python mais comuns. Eles instalam pacotes para o computador inteiro, muitas vezes usam versões mais antigas, e não têm tantas versões disponíveis. Esse não é o método recomendado de instalação.

Ubuntu e Debian#

Usando apt-get:

sudo apt-get install python3-scipy

Fedora#

Usando dnf:

sudo dnf install python3-scipy

macOS#

macOS não tem um gerenciador de pacotes pré-instalado, mas você pode instalar o Homebrew e usá-lo para instalar a SciPy (e o Python em si):

brew install scipy

Cuidado: compilar a SciPy a partir do código fonte pode ser um exercício não trivial. Recomendamos o uso de binários, em vez disso, se eles estiverem disponíveis para a sua plataforma em um dos métodos acima. Para mais detalhes sobre como compilar a partir do código fonte, consulte o guia de compilação a partir do código fonte na documentação da SciPy.

Veja os próximos passos no guia do usuário SciPy.

Instalando com os stubs de tipagem#

Os stubs de tipagem estática estão disponíveis através de um pacote separado, scipy-stubs, no PyPI e conda-forge. Você também pode instalar a SciPy e scipy-stubs como um único pacote, através do pacote scipy-stubs[scipy] no PyPI, ou do pacote scipy-typed no conda-forge. Para obter uma versão específica do arquivo ‘x.y.z’ da SciPy (como ‘1.14.1’), você deve instalar a versão ‘x.y.z.*’, por exemplo:

uv add "scipy-stubs[scipy]==1.14.1.*" # or
pixi add "scipy-typed=1.15.0.*" # or
python -m pip install "scipy-stubs[scipy]" # or
conda install "scipy-typed>=1.14"

Por favor, envie questões diretas sobre suporte à tipagem estática para o repositório do scipy-stubs no GitHub.

On this page