GF Logo

Grammatical Framework Download and Installation

GF 3.3.3 was released on 3 March 2012.

What's new? See the Release notes.

Binary packages

Platform Download How to install
Linux (32-bit) gf-3.3.3-bin-i386-linux.tar.gz sudo tar -C /usr/local -zxf gf-3.3.3-bin-i386-linux.tar.gz
Linux (64-bit) gf-3.3.3-bin-amd64-linux.tar.gz sudo tar -C /usr/local -zxf gf-3.3.3-bin-amd64-linux.tar.gz
MacOS X gf-3.3.3-bin-intel-mac.tar.gz sudo tar -C /usr/local -zxf gf-3.3.3-bin-intel-mac.tar.gz
Windows gf-3.3.3-bin-windows.zip unzip gf-3.3.3-bin-windows.zip

Notes

The Windows package is installed by just unpacking it anywhere. It finds the libraries relative to the .exe file.

The MacOS tar package works on 10.5 (Leopard), 10.6 (Snow Leopard) and probably also 10.7 (Lion).

The MacOS and Linux .tar.gz packages are designed to be installed in /usr/local. You can install them in other locations, but then you need to set the GF_LIB_PATH environment variable:

    export GF_LIB_PATH=/usr/local/share/gf-3.3.3/lib

where /usr/local should be replaced with the path to the location where you unpacked the package.

Installing the latest release from source

GF is on Hackage, so the prodedure is fairly simple:

  1. Install the Haskell Platform (versions 2010.2.0.0 - 2011.4.0.0 should work) (see notes 2&3 below)
  2. cabal update
  3. On Linux: install some C libraries from your Linux distribution (see note 1 below)
  4. cabal install gf

You can also download the full source package from here: gf-3.3.3.tar.gz.

Notes

The above steps installs GF for a single user. The executables are put in $HOME/.cabal/bin (or, with recent versions of the Haskell platform on Mac OS X, in $HOME/Library/Haskell/bin), so it is a good idea to put a line in your .bash_profile to add that directory to you path:

    PATH=$HOME/.cabal/bin:$PATH

or

    PATH=$HOME/Library/Haskell/bin:$PATH

Note 1. GF uses haskeline, which on Linux depends on some non-Haskell libraries that won't be installed automatically by cabal, and therefore need to be installed manually. Here is one way to do this:

Note 2. GF (<=3.3.3) does not compile with the most recent versions of GHC (>=7.2). GF does not compile with the most recent versions of Alex (>=3.0).

Note 3. The Haskell Platform for Mac OS X page states that you need Xcode 3.2 or later, but in fact it appears you need Xcode 3.2.3 or later. If you have Xcode 3.2.2, you can get an error from the linker: ld: unknown option: -no_pie.

Installing from the latest developer code

The first time:

    darcs get --lazy http://www.grammaticalframework.org/ GF
    cd GF
    cabal install

Subsequently:

    cd GF
    darcs pull -a
    cabal install

The above notes for installing from source apply also in this case. For more info, see the GF Developers Guide.

Older releases