SageMath é um sistema de software matemático de código aberto gratuito que se baseia em muitos pacotes de código aberto existentes, incluindo NumPy, SciPy, matplotlib, Sympy, Maxima, GAP, FLINT, R e mais. Ao contrário de softwares proprietários como Magma, Maple, Mathematica e MATLAB, o Sage é de uso gratuito e permite visualizar e modificar o código-fonte. Se você estiver familiarizado com Python, se sentirá em casa com o Sage, pois ele estende o Python com um conjunto robusto de ferramentas matemáticas.

A maneira mais fácil de começar a usar o Sage é executando o código em uma pasta de trabalho baseada em navegador em uma plataforma chamada CoCalc. O nível gratuito do CoCalc oferece vários benefícios, incluindo colaboração, gerenciamento automático de dependências e a conveniência de executar código Sage sem instalar o software localmente. No entanto, depois de usar o CoCalc por um tempo, comecei a querer uma configuração mais rápida, livre das limitações de um ambiente em nuvem. Isso me levou a instalar o Sage localmente em minha máquina.

Se você estiver executando o Windows, a instalação do Sage requer algumas etapas extras.

1. Baixe o subsistema Windows para Linux. Certifique-se de estar usando WSL2.
2. Leitura Configurar um ambiente de desenvolvimento WSL também é útil.

Você pode encontrar instruções para instalação local no Guia de Instalação do Sage.

Existem várias maneiras de instalar o Sage, cada uma com suas vantagens. Instalar o Sage a partir do código-fonte oferece maior flexibilidade, mas é um processo demorado que pode apresentar alguns desafios. A instalação das dependências necessárias pode levar um tempo considerável, e o comando make — usado para construir o Sage — também exigirá um pouco de paciência, dependendo dos recursos do seu computador.

Para quem busca um processo de instalação mais simples e rápido, utilizar o conda-forge é uma excelente alternativa. Conda-forge é uma coleção de pacotes para conda dirigida pela comunidade, facilitando a instalação e o gerenciamento do Sage sem lidar com as complexidades de uma construção de código-fonte. Veja como começar:

curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash Miniforge3-$(uname)-$(uname -m).sh
conda create -n sage sage python=3.11

Depois de instalar o Sage via conda, você verá uma mensagem semelhante à seguinte. Preste atenção às instruções fornecidas, pois elas orientam você sobre como ativar e gerenciar seu novo ambiente Sage:

Transaction finished

To activate this environment, use:

    micromamba activate /home/samuel-lubliner/miniforge3

Or to execute a single command in this environment, use:

    micromamba run -p /home/samuel-lubliner/miniforge3 mycommand

installation finished.
Do you wish to update your shell profile to automatically initialize conda?
This will activate conda on startup and change the command prompt when activated.
If you'd prefer that conda's base environment not be activated on startup,
   run the following command when conda is activated:

conda config --set auto_activate_base false

You can undo this by running `conda init --reverse $SHELL`? [yes|no]
[no] >>> no

Este prompt pergunta se você deseja que o conda seja inicializado automaticamente sempre que seu shell for iniciado. Prefiro manter meu ambiente limpo, então optei por não. Essa escolha mantém o ambiente base inativo na inicialização, o que ajuda a evitar sobrecarregar o prompt de comando com ativações de ambiente desnecessárias. Se você preferir esta configuração, digite não quando solicitado.

You have chosen to not have conda modify your shell scripts at all.
To activate conda's base environment in your current shell session:

eval "$(/home/samuel-lubliner/miniforge3/bin/conda shell.YOUR_SHELL_NAME hook)"

To install conda's shell functions for easier access, first activate, then:

conda init

Thank you for installing Miniforge3!

A ativação manual do seu ambiente garante que você mantenha o controle sobre quando e como seus ambientes conda são carregados. Essa abordagem é benéfica se você usar vários ambientes.

Como optei por não permitir que o conda modificasse meus scripts de shell, executo o Sage manualmente usando os seguintes comandos. Este método garante um ambiente limpo e me dá controle sobre quando ativar o Sage:

samuel_lubliner@DESKTOP-QGSGOAI:~$ eval "$(/home/samuel_lubliner/miniforge3/bin/conda shell.bash hook)"
(base) samuel_lubliner@DESKTOP-QGSGOAI:~$ conda activate sage
(sage) samuel_lubliner@DESKTOP-QGSGOAI:~$ sage -n jupyter

• O primeiro comando inicializa conda em seu shell atual.
• O segundo comando ativa o ambiente sage.
• O terceiro comando inicia o Sage com a interface do notebook Jupyter.

Observe que (base) indica que o ambiente base conda está ativado e (sage) mostra que o ambiente sage está ativo. Executar esses comandos sempre pode se tornar repetitivo, então vamos automatizar esse processo criando um script bash. Podemos criar o arquivo sage_nb.sh. Se você estiver usando WSL, os documentos recomendam:

#!/bin/bash
# Switch to desired windows directory
cd /mnt/c/path/to/desired/starting/directory
# Start the Jupyter notebook
SAGE_ROOT/sage --notebook
# Alternatively you can run JupyterLab - delete the line above, and uncomment the line below
#SAGE_ROOT/sage --notebook jupyterlab

No meu caso, instalei o JupyterLab porque prefiro sua interface mais moderna. Aqui está meu roteiro:

#!/bin/bash
# Start JupyterLab
/home/samuel_lubliner/miniforge3/envs/sage/bin/sage --notebook jupyterlab

Para executar o script, primeiro você precisa torná-lo executável:

chmod ug x ~/sage_nb.sh

Agora você pode executar o script sempre que quiser iniciar o Sage:

cd ~
./sage_nb.sh

Se tudo estiver configurado corretamente, a execução do script iniciará o servidor Jupyter em seu terminal. A partir daqui, você pode começar a trabalhar com o Sage no seu navegador.

Se preferir uma abordagem mais amigável, você pode levar este script bash um passo adiante, criando um atalho clicável em sua área de trabalho. Isso permite que você inicie o Sage e o JupyterLab com um clique duplo. Você pode encontrar instruções detalhadas sobre como criar este atalho na documentação do SageMath.