Differences between revisions 6 and 22 (spanning 16 versions)
Revision 6 as of 2020-06-25 20:42:49
Size: 1346
Editor: saraedum
Comment: this is easier now
Revision 22 as of 2021-11-11 22:37:24
Size: 2377
Editor: dimpase
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
Experimental [[https://conda.io/docs/|Conda]] packages for Linux & OSX are available through [[https://conda-forge.github.io/|conda-forge]]. [[https://conda.io/docs/|Conda]] packages for Linux & macOS are available through [[https://conda-forge.github.io/|conda-forge]].
Line 7: Line 7:
In short: Install `sage` from conda-forge. In short: Install `sage` from [[https://conda-forge.org|conda-forge]].
Line 9: Line 9:
To install sage on your machine (without the need for root permissions):  * Download and install [[https://github.com/conda-forge/miniforge/#mambaforge|Mambaforge]].
   i.e., open a Terminal,
     `curl -L -O https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-\$(uname)-\$(uname -m).sh`
Line 11: Line 13:
 * Install [[https://conda.io/miniconda.html|Miniconda for Python 3]]
 * export your `PATH` (and `hash -r` or `rehash`)
 * Make sure your locale is UTF-8.
 * Use conda-forge packages: `conda config --add channels conda-forge; conda config --set channel_priority strict`
 * create an environment for sage: `conda create -n sage sage`
 * enter your environment: `source activate sage`
 * enjoy: `sage`
     `sh Mambaforge-\$(uname)-\$(uname -m).sh`
 * Create a "sage" environment and pick a version of SageMath, i.e., open a new terminal and `mamba create -n sage sage=9.3`
 * To run SageMath, activate the environment you just created and run SageMath, i.e., `source activate sage` and `sage`
Line 19: Line 17:
= Development = = Maintenance =
Line 22: Line 20:

= Conda for Sage Developers =

You can develop Sage without building any of its dependencies (experimental) --- on my machine this takes 5 minutes. Assume you obtained Sage source tree and changed to its root.

{{{
$ export SAGE_NUM_THREADS=24 # or whatever the meaningful value for you is - no more than the number of cores.
$ conda install mamba
$ mamba create -n sage-build python=3.9 gettext autoconf automake libtool pkg-config
$ conda activate sage-build
$ ./bootstrap
$ mamba env update -n sage-build -f environment-optional.yml
$ mamba env update -n sage-build -f src/environment.yml
$ #mamba env update -n sage-build -f src/environment-optional.yml
$ conda activate sage-build
$ ./configure --with-python=$CONDA_PREFIX/bin/python --with-system-gcc=force --enable-download-from-upstream-url
$ cd src
$ python setup.py install
$ sage -c 'print(version())'
SageMath version 9.2, Release Date: 2020-10-24
}}}
Line 26: Line 45:
There are still some issues with Conda. Not all tests pass and some things don't work:
 * #20382
 * …

To check whether there are known issues with Conda:

 * https://trac.sagemath.org/query?order=id&desc=1&summary=~conda
Line 31: Line 51:

https://conda.io/docs/_images/conda_logo.svg

Conda packages for Linux & macOS are available through conda-forge.

Setting Up

In short: Install sage from conda-forge.

  • Download and install Mambaforge.

    • i.e., open a Terminal,
      • curl -L -O https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-\$(uname)-\$(uname -m).sh

        sh Mambaforge-\$(uname)-\$(uname -m).sh

  • Create a "sage" environment and pick a version of SageMath, i.e., open a new terminal and mamba create -n sage sage=9.3

  • To run SageMath, activate the environment you just created and run SageMath, i.e., source activate sage and sage

Maintenance

The packages necessary to run sage are developed on the github pages of conda-forge. The actual sage package and many of its dependencies are maintained by Isuru Fernando (and a few volunteers).

Conda for Sage Developers

You can develop Sage without building any of its dependencies (experimental) --- on my machine this takes 5 minutes. Assume you obtained Sage source tree and changed to its root.

$ export SAGE_NUM_THREADS=24 # or whatever the meaningful value for you is - no more than the number of cores.
$ conda install mamba
$ mamba create -n sage-build python=3.9 gettext autoconf automake libtool pkg-config
$ conda activate sage-build
$ ./bootstrap
$ mamba env update -n sage-build -f environment-optional.yml
$ mamba env update -n sage-build -f src/environment.yml
$ #mamba env update -n sage-build -f src/environment-optional.yml
$ conda activate sage-build
$ ./configure --with-python=$CONDA_PREFIX/bin/python --with-system-gcc=force  --enable-download-from-upstream-url
$ cd src
$ python setup.py install
$ sage -c 'print(version())'
SageMath version 9.2, Release Date: 2020-10-24

Open Issues

General

To check whether there are known issues with Conda:

Windows

There is likely not going to be a working package in the near future, see https://groups.google.com/d/msg/sage-devel/wyaV8x5qolI/jVS4DKBvCAAJ.

Conda (last edited 2024-08-28 05:30:57 by mkoeppe)