Skip to content

Prerequisites and Local Installation

These guides assume you are comfortable with the Command Line, Git and Python. You must have all of these installed on your machine. You are also strongly encouraged to have a GitHub account.

This document outlines everything you need installed on your machine in order to pursue the "advanced" dictionary creation path.

There are a lot of guides for the "advanced" path and some of them are quite involved. Before each guide, there is a little paragraph (like the one above) that discusses the knowledge that you're assumed to have before attempting the guide, please take note of that! Remember that if you don't know one or more of the pre-requisite skills, the internet is a wonderful place with lots of resources for learning.

Operating System

Mother Tongues dictionaries can be created on any operating system (Mac, Windows, Linux, etc.)

We have made our best effort to ensure that all documentation found here works cross-platform.

That said, Mother Tongues is primary developed on MacOS and recieves most extensive testing on that operating system. If you find something that does not work for you, please modify actions according to your operating system - and feel free to let us know! (or contribute!)

Prerequisites

Before setting up Mother Tongues, you need the following installed on your machine

Installing Mother Tongues

The simplest way to install mothertongues is with pip. Eventually we will publish this version on PyPi, but for now, please clone and install locally:

# Clone repo and UI submodule
git clone https://github.com/MotherTongues/mothertongues.git --recursive
cd mothertongues && pip install --editable .

Planning on Customizing Mother Tongues?

If you plan on modifying MTD code, run the following commands to install the git repos locally.

# Clone repo and UI submodule (if you haven't already from the above command)
git clone https://github.com/MotherTongues/mothertongues.git --recursive

# Build the UI:
cd mothertongues/mothertongues-UI && npm install

# Build the Python Development version of the UI:
npx nx build mtd-mobile-ui --configuration=pydev

# Install the Python package:
cd .. && poetry install --with dev,docs

Comments