View source for Using the tools on your own system

It's possible to use the tools we make use of in class on your own system.

The following is the complete list of tools you'll need:
* The core tools:
** Apertium, with <code>lttoolbox</code> and other dependencies
** <code>apertium-lex-tools</code>, <code>apertium-separable</code>, <code>apertium-recursive</code>, <code>apertium-anaphora</code>
** HFST
** CG-3
** <code>lexd</code>
* <code>udpipe</code> (not needed Spring 2021)
* Miscellaneous tools (from repo)

== Installing core tools ==
There are three main methods to install the core tools:
* If you run Linux, [[:apertium:Install_Apertium_core_using_packaging|set up your package manager to use Apertium's repos]] using the nightly script.
* If you run Windows 10, [https://docs.microsoft.com/en-us/windows/wsl/install-win10 set up WSL] and then [[[[:apertium:Install_Apertium_core_using_packaging|set up the package manager to use Apertium's repos]] using the nightly script.
* If you run macOS, [[#Apertium installation on Mac using homebrew|use homebrew]] to install the tools.

Alternatively, you can install VirtualBox and use a [[:apertium:Apertium VirtualBox|Linux virtual machine with Apertium tools installed]].


=== Apertium installation on Debian/Ubuntu (including under Windows WSL) ===

Set up the [[:apertium:Install_Apertium_core_using_packaging|Apertium nightly script]].

Then install all development packages

 $ sudo apt-get -f install apertium-all-dev

That should install all the core tools on your system!

=== Apertium installation on Mac using homebrew ===

==== Install homebrew ====

[https://brew.sh Homebrew] is a package manager for Mac.  To install it, open a terminal run the following:

 $ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

This will take several minutes.

''Note that you'll probably need the XCode developer tools from Apple to install homebrew.  If you don't have them installed, Homebrew may direct you to install them—perhaps automatically—but it may not.''

==== Install dependencies from homebrew ====

 $ brew install gperftools help2man pcre icu4c perl518 gawk autoconf automake pkg-config cmake wget gcc

This will take a couple minutes.

==== Install apertium core tools and HFST ====

 $ wget https://apertium.projectjj.com/osx/install-nightly.sh -O - | bash

This will take a minute.

== UDpipe ==
Follow [https://ufal.mff.cuni.cz/udpipe/install these instructions].

== Misc tools ==

First, for <code>morph-test</code> to work, you'll need PyYAML.

 # on macOS using homebrew:
 $ pip3 install PyYAML
 # on Debian/Ubuntu (including under Windows with WSL):
 $ sudo apt-get install python3-yaml

Then clone the tools repo:

 $ git clone --recurse-submodules git@github.swarthmore.edu:Ling073-sp21/tools.git

And then run <code>make</code> or <code>sudo make</code>.


[[Category:Tutorials]]
[[Category:Tools]]