Skip to main content

Stand-alone OpenFST bindings for Python

Project description


Build Status Python Version Code Style

OpenFst-Python exposes the official Python API to OpenFst (officially called pywrapfst), but includes all the required OpenFst libraries in the Python package, so you don't need to install it separately.

The version number of OpenFst-Python is the same as the OpenFst version used. The current version uses OpenFst 1.7.2.

Build Requirements

The build process will download and build OpenFst from the official webpage, so you need an Internet connection and all OpenFst dependencies. Essentially, you will need:


Most likely, you want to avoid the build process. Then, simply install the package from PyPI:

pip install openfst-python

Alternatively, if you are installing from sources, you can simply do:

python install

Notice that this downloads the appropriate version of OpenFst directly from the Internet. If you don't have an Internet connection but are already in possession of the appropriate tar.gz file, you can use the following command:

python build --download-dir=DIRECTORY_CONTAINING_OPENFST_TAR_GZ
python install


The Python API is the official one provided by OpenFst. Please, refer to its documentation.

A toy example:

import openfst_python as fst

f = fst.Fst()
s0 = f.add_state()
s1 = f.add_state()
s2 = f.add_state()
f.add_arc(s0, fst.Arc(1, 2, fst.Weight(f.weight_type(), 3.0), s1))
f.add_arc(s0, fst.Arc(1, 3, fst.Weight.One(f.weight_type()), s2))
f.add_arc(s1, fst.Arc(2, 1, fst.Weight(f.weight_type(), 1.0), s2))
f.set_final(s2, fst.Weight(f.weight_type(), 1.5))


The OpenFst library is licensed under the Apache License, Version 2.0. OpenFst-Python is just a wrapper of its official Python API, so I am using the same license for most of the source code. ac_python_devel.m4 was not written by me and it is licensed under the GPL license.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for openfst-python, version 1.7.3
Filename, size File type Python version Upload date Hashes
Filename, size openfst_python-1.7.3-cp27-cp27mu-manylinux1_x86_64.whl (15.0 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size openfst_python-1.7.3-cp35-cp35m-manylinux1_x86_64.whl (15.0 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size openfst_python-1.7.3-cp36-cp36m-manylinux1_x86_64.whl (15.0 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size openfst_python-1.7.3-cp37-cp37m-manylinux1_x86_64.whl (15.0 MB) File type Wheel Python version cp37 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page