Skip to content
Astrophysical Multipurpose Software Environment. This is the main repository for AMUSE
AMPL Fortran Objective-C C Python C++ Other
Branch: master
Clone or download

Latest commit

Latest commit ff24ffd May 22, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates (add question) Apr 3, 2019
bin move amusifier script and template to bin, change option to get amusedir May 27, 2019
data Working on EVtwin interface: data directory Jun 13, 2014
doc remove deprecated stuff Mar 10, 2020
examples Make textbook and other examples python3 compatible (#193) Nov 25, 2019
lib Fix building sapporo2, bonsai1 and pikachu (#596) Feb 28, 2020
m4 fix fortran compile w/o MPI Oct 30, 2019
packages Add mikkola package Dec 17, 2019
src/amuse fixes for remappers May 22, 2020
support version bump Mar 24, 2020
test fixes for remappers May 22, 2020
.readthedocs.yml only build html documentation Feb 5, 2020
.travis.yml Merge branch 'python2' Nov 28, 2019
.zenodo.json working zenodo and citation Oct 3, 2018
CITATION.cff add comment with command to generate .zenodo Oct 3, 2018 Add missing reference to AMUSE style guide Jun 8, 2018
LICENSE added license and notice Jun 16, 2017 move amusifier script and template to bin, change option to get amusedir May 27, 2019
Makefile Makefile to enable autoconfigure Mar 14, 2020
NOTICE Update NOTICE Mar 20, 2019 update README to reflect transuition to python 3 Nov 26, 2019
codecov.yml Create codecov.yml Oct 31, 2019 improve detection of netcdf4 libraries Jul 31, 2019
configure Version bump Mar 24, 2020 Merge branch 'master' into python3 Nov 12, 2019
cuda_self_help rename legacy_tests directory to codes_tests directory, see ticket #182 Jan 17, 2011
pyproject.toml make mpi optional for amuse-framework (#521) Nov 1, 2019
requirements.txt Add requirements.txt file Feb 26, 2019 Store version in one place Feb 13, 2020
slowtests Added script to also run slowtests, tests turned off by default for s… Jul 5, 2010

AMUSE: The Astrophysical Multipurpose Software Environment

DOI PyPI version

This repository contains the AMUSE software. With AMUSE you can write scripts to simulate astrophysical problems in different domains.

The project website is:

and the documentation can be found at:

Getting Started

In short, most probably

pip install amuse

should get you going if you have a linux or Mac were you compile codes on (HDF5 and an MPI libraries must be installed).

Below are some hints for a quick install, if these fail please look for options at the detailed descriptions of the installation procedure in the documents in the 'doc/install' directory.


To build AMUSE from source you need to have a working build environment. The AMUSE build system needs C/C++ and fortan 90 compilers, we recommend a recent version of GCC.

In Ubuntu you can setup the environment with (as root):

apt-get install build-essential curl g++ gfortran gettext zlib1g-dev

Other distributions have similar package or package groups available.

In OS X you can use the homebrew or macports package manager (both require the Apple Developer Tools and Xcode to be installed).


AMUSE needs Python 3 version >=3.5 installed preferably with pip and virtualenv. It may be necessary to update pip to a recent version. If you cannot use Python 3, legacy support for Python 2 is available in the AMUSE 12 release and the python2 branch.

Installing Prerequisites

The following libraries need to be installed:

  • HDF (version 1.6.5 - 1.8.x)
  • MPI (OpenMPI or MPICH)

The following are needed for some codes:

  • FFTW (version >= 3.0)
  • GSL
  • CMake (version >= 2.4)
  • GMP (version >= 4.2.1)
  • MPFR (version >= 2.3.1)

Installing+building AMUSE

AMUSE can be installed through pip:

pip install [--user] amuse

This will build and install AMUSE with an extensive set of codes. If necessary this will also install some required Python packages:

  • Numpy (version >= 1.3.0)
  • h5py (version >= 1.2.0)
  • mpi4py (version >= 1.0)
  • nose (version >= 0.11)
  • docutils (version >= 0.6)

If you are not using pip these must be installed by hand.

It is possible to install the minimal framework by:

pip install [--user] amuse-framework

This does not include any codes. These can be added

pip install [--user] amuse-<code name>

AMUSE Development

If you are using Python 2, an AMUSE development install can also be handled through pip by executing (in the root of a clone of the repository)

pip install -e .

after this the codes need to be build:

python develop_build

Running the tests

AMUSE comes with a large set of tests, most can be run automatically. To run these tests start the nosetests command from the main amuse directory (directory this README file lives in).

To run these tests do:

  1. install the tests
pip install [--user] amuse-tests
  1. Run the automatic tests
nosetests -v amuse.tests.suite
You can’t perform that action at this time.