We need African researchers from ACROSS the continent to join our effort in building translation models for African languages. Masakhane means "We Build Together" in isiZulu. Phase 1 consists of getting baseline translation results for as many languages as possible. Phase 2 consists of combining all our powers and doing some transfer learning to get significant improvement on the models.
First, we encourage you read up on our website: masakhane.io
All language pairs that we currently have benchmarks for can be found here
-
Put African NLP on the map by publishing a paper at a top-tier NLP conference featuring as many languages and countries and researchers as possible.
-
Faciliate the development of an NLP community in Africa
-
Spur research and focus on African languages, by providing a starting point for other researchers to begin
This is so we can feature you on our webpage masakhane.io, google group and invite you to our weekly meetings & slack. This aims to faciliate your participation in the movement. Please email the following to [email protected]:
- Your Full Name
- A preferred social media link
- The language(s) you'll be working on (or your general relevant specialty - if you're an expert at machine translation and - would like to boost the community through that)
- A picture
- Your affiliation and role.
There are many ways to contribute to Masakhane
- Contribute a trained model and related code for your language
- Contribute analysis of data/models for any African languages. You do not need any technical experience for this! If you're a linguist, we can pair you up with a machine translation practitioner and you can help contribute analysis
- Contribute to documentation or the base "notebook" that will improve the experience of others
- Provide advice or help tune models for their languages and datasets
- Help administrate! Working with so many researchers can be quite a challenge!
- Help with infrastructure and compute! Do you have spare compute to donate? Let us know! We're always looking for more!
- Help document our discussions, progress. This is VERY much needed
We have an example colab notebook which trains a model for English-to-Zulu translation. Open it in [Google Colab](google colab) - you can select it by going to the GitHub section when opening a new project.
This is a huge challenge, but luckily we have a place to start! At ACL 2019, this paper was published. The short story? Turns out the Jehovah's Witness community has been translating many many documents and not all of them are religious. And their language representation is DIVERSE.
Check out this spreadsheet HERE to see if your language is featured, then go to Opus to find the links to the data: http://opus.nlpl.eu/JW300.php
We also provide a script for easy downloading and BPE-preprocessing of JW300 data from OPUS: jw300_utils/get_jw300.py
. It requires the installation of the opustools-pkg Python package. Example: For dowloading and pre-processing the Acholi (ach) and the Nyaneka (nyk) portions of JW300, call the script like this:
python get_jw300.py ach nyk --output_dir jw300
Then we still have some options! Our community has been searching wide and far! Drop us a mail and we'll get you onboarded on our slack: [email protected]. We will be updating our wiki with other resources as we find them!
If nothing comes from that, then we're working with CocoHub.cc
Your next step is to use the JW300 dataset in the colab notebook and run it. Most pieces of advice are within the notebook itself. We are constantly improving that notebook and are open to any recommendations. Struggled to get going? Then let's work together to build a notebook that's easier to use! Create a github issue or email us!
Amazing! You're created your first baseline. Now we need to get the code and data and results into this github repository
In order for us to consider your result submission official, we need a couple of things:
-
The notebook that will run the code. The notebook MUST run on on someone else account and the data that it uses should be publically accessible (i.e. if I download the notebook and run it, it must work - so shouldn't be using any private files). If you're wondering how to do this, don't fear! Drop us a line and we will work together to make sure the submission is all good! :)
-
The test sets - in order to replicate this and test against your results, we need saved test sets uploaded separately.
-
A README.md that describes the (a) the data used - esp important if it's a combination of sources (b) any interesting changes to the model (c) maybe some analysis of some sentences of the final model
-
The model itself. This can be in the form of a google drive or dropbox link. We will be finding a home for our trained models soon. For models to be used for transfer learning, further trained, or deployed, you need to provide:
- a checkpoint with the parameters (
.ckpt
file), - the source and target vocabulary (
src_vocab.txt
,trg_vocab.txt
), - the configuration file (
config.yaml
), - and if applicable: the BPE codes or scripts for your pre-processing pipeline. Joey NMT saves the first three in the model directory.
- a checkpoint with the parameters (
-
The results - the train, dev, and test set BLEU score
We will be further expanding our analysis techniques so it's super important we have a copy of the model and test sets now so we don't need to rerun the training just to do the analysis
Once you have all of the above, please create a pull request into the repository. See guidelines here.
Also see this as an example for the structure of your contribution
Structure:
/<src-lang>-<tgt-lang>
/<technique> -- this could be "jw300-baseline" or "fine-tuned-baseline" or "nig-newspaper-dataset"
- notebook.ipynb
- README.md
- test.src
- test.tgt
- results.txt
- src_vocab.txt
- trg_vocab.txt
- src.bpe
- [trg.bpe if the bpe model is not joint with src]
- config.yaml
- any other files, if you have any
Example:
/en-xh
/xhnavy-data-baseline
- notebook.ipynb
- README.md
- test.xh
- test.en
- results.txt
- src_vocab.txt
- trg_vocab.txt
- en-xh.4000.bpe
- config.yaml
- preprocessing.py
Here is a link to a pull request that has the relevant things.
Feeling nervous about contributing your first pull request or unsure how to proceed? Please don't feel discouraged! Drop us an email or a slack message and we will work together to get your contribution in ship shape!
Cool! So there are many ways to improve results. We've highlighed a few of these in this document. Got other ideas? Drop us a line or submit a PR!
See Code of Conduct