gf-core/download/index-3.11.md

title, date

title	date
Grammatical Framework Download and Installation	25 July 2021

GF 3.11 was released on 25 July 2021.

What's new? See the release notes.

Note: GF core and the RGL

The following instructions explain how to install GF core, i.e. the compiler, shell and run-time systems. Obtaining the Resource Grammar Library (RGL) is done separately; see the section at the bottom of this page.

---

Installing from a binary package

Binary packages are available for Debian/Ubuntu, macOS, and Windows and include:

• GF shell and grammar compiler
• gf -server mode
• C run-time system
• Java & Python bindings to the C run-time system

Unlike in previous versions, the binaries do not include the RGL.

Binary packages on GitHub

Debian/Ubuntu

There are two versions: gf-3.11-ubuntu-18.04.deb for Ubuntu 18.04 (Cosmic), and gf-3.11-ubuntu-20.04.deb for Ubuntu 20.04 (Focal).

To install the package use:

sudo apt-get install ./gf-3.11-ubuntu-*.deb

macOS

To install the package, just double-click it and follow the installer instructions.

The packages should work on at least Catalina and Big Sur.

Windows

To install the package, unpack it anywhere.

You will probably need to update the PATH environment variable to include your chosen install location.

For more information, see Using GF on Windows (latest updated for Windows 10).

Installing from the latest developer source code

If you haven't already, clone the repository with:

git clone https://github.com/GrammaticalFramework/gf-core.git

If you've already cloned the repository previously, update with:

git pull

Then install with:

cabal install

or, if you're a Stack user:

stack install

For more info on working with the GF source code, see the GF Developers Guide.

Installing the Python bindings from PyPI

The Python library is available on PyPI as pgf, so it can be installed using:

pip install pgf

We provide binary wheels for Linux and macOS, which include the C runtime and are ready-to-go. If there is no binary distribution for your platform, this will install the source tarball, which will attempt to build the binding during installation, and requires the GF C runtime to be installed on your system.

---

Installing the RGL from a binary release

Binary releases of the RGL are made available on GitHub. In general the steps to follow are:

1. Download a binary release and extract it somewhere on your system.
2. Set the environment variable GF_LIB_PATH to point to wherever you extracted the RGL.

Installing the RGL from source

To compile the RGL, you will need to have GF already installed and in your path.

1. Obtain the RGL source code, either by:

• cloning with git clone https://github.com/GrammaticalFramework/gf-rgl.git
• downloading a source archive here

2. Run make in the source code folder.

For more options, see the RGL README.

---

Older releases

• GF 3.10 (December 2018)
• GF 3.9 (August 2017)
• GF 3.8 (June 2016)
• GF 3.7.1 (October 2015)
• GF 3.7 (June 2015)
• GF 3.6 (June 2014)
• GF 3.5 (August 2013)
• GF 3.4 (January 2013)
• GF 3.3.3 (March 2012)
• GF 3.3 (October 2011)
• GF 3.2.9 source-only snapshot (September 2011)
• GF 3.2 (December 2010)
• GF 3.1.6 (April 2010)