Subsections


1 Installation Requirements

There are two ways to install SAGE. This document describes both possibilities.

1.1 Binary install

This is the easiest and fastest.

Assumptions: You have a computer with about 150 megabytes free disk space and the operating system is Linux (32-bit or 64-bit) or OS X.

Note: There is no currently no support for use of SAGE with Windows XP or Cygwin/Windows.

If you have Linux or OS X, download the compressed file (named sage*.tgz) from http://modular.fas.harvard.edu/SAGEbin/ and unpack it on your computer in a directory which you have permissions, tar zxvf sage*.tgz. Next cd into the directory SAGEHOME/bin and type ./sage, where SAGEHOME is your sage home directory.

If you have windows:

  1. Download the windows binary from http://modular.fas.harvard.edu/SAGEbin/.

  2. Get and install cygwin. It doesn't matter very much which packages you install. Make sure your login name and home directory does not contain any spaces.

  3. Run cygwin (open a cygwin shell).

  4. Extract sage*.tgz into your cygwin home directory: tar jxvf sage*.tgz.

  5. Go into the sage home directory and run SAGE:
       cd sage*
       ./sage
    

1.2 Build from source

More familiarity with computers is required to build SAGEfrom source. If you do have all the tools, the process is relativley painless.

Assumptions: You have a computer with about 350 megabytes free running Linux (32-bit or 64-bit), FreeBSD, or OS X with development tools. In particular, the following standard command-line programs must be installed on your box:

    gcc, make, m4, perl, ranlib, tar, sh
In particular, although much of SAGEis written in Python, you do not need Python pre-installed on your computer, since the SAGE installation includes everything you need. When the installation program is run, it will check that you have each of the above-listed prerequisites, and inform you of any that are missing.

Note: SAGEis currently being developed using GCC Version 4.0.1, and is likely to compile fine with versions of gcc newer than 3.3.0. The reason perl is required is that the NTL configuration script is written in perl; it would be very nice if somebody were to rewrite it use autoconf in order to avoid this dependency.

After extracting the SAGEtarball, the subdirectory source contains the source distributions for everything on which SAGE depends. We emphasize that all of this software is included with SAGE, so you do not have to worry about trying to download and install any one of these packages yourself.

Note: On tests using various Linux computer systems the known problems are:

Software Included with SAGE

Name Description
bzip2 bzip2 compression library
GMP GNU multiprecision arithmetic library
gmpy GMP for Python
IPython Interactive Python shell
pari PARI number theory library
pexpect Python expect (for remote control of other systems)
Pyrex Compiled extension language for Python
Python Python
readline GNU Readline line editor library
ZODB Zope Object Database

See About this document... for information on suggesting changes.