command_line_tools.rst 1.78 KB
Newer Older
Myle Ott's avatar
Myle Ott committed
1
2
3
4
5
6
7
.. _Command-line Tools:

Command-line Tools
==================

Fairseq provides several command-line tools for training and evaluating models:

Myle Ott's avatar
Myle Ott committed
8
9
10
11
12
13
- :ref:`fairseq-preprocess`: Data pre-processing: build vocabularies and binarize training data
- :ref:`fairseq-train`: Train a new model on one or multiple GPUs
- :ref:`fairseq-generate`: Translate pre-processed data with a trained model
- :ref:`fairseq-interactive`: Translate raw text with a trained model
- :ref:`fairseq-score`: BLEU scoring of generated translations against reference translations
- :ref:`fairseq-eval-lm`: Language model evaluation
Myle Ott's avatar
Myle Ott committed
14
15


Myle Ott's avatar
Myle Ott committed
16
.. _fairseq-preprocess:
Myle Ott's avatar
Myle Ott committed
17

Myle Ott's avatar
Myle Ott committed
18
19
fairseq-preprocess
~~~~~~~~~~~~~~~~~~
Myle Ott's avatar
Myle Ott committed
20
21
22
.. automodule:: preprocess

    .. argparse::
Myle Ott's avatar
Myle Ott committed
23
24
25
        :module: fairseq.options
        :func: get_preprocessing_parser
        :prog: fairseq-preprocess
Myle Ott's avatar
Myle Ott committed
26
27


Myle Ott's avatar
Myle Ott committed
28
.. _fairseq-train:
Myle Ott's avatar
Myle Ott committed
29

Myle Ott's avatar
Myle Ott committed
30
31
fairseq-train
~~~~~~~~~~~~~
Myle Ott's avatar
Myle Ott committed
32
33
34
35
36
.. automodule:: train

    .. argparse::
        :module: fairseq.options
        :func: get_training_parser
Myle Ott's avatar
Myle Ott committed
37
        :prog: fairseq-train
Myle Ott's avatar
Myle Ott committed
38
39


Myle Ott's avatar
Myle Ott committed
40
.. _fairseq-generate:
Myle Ott's avatar
Myle Ott committed
41

Myle Ott's avatar
Myle Ott committed
42
43
fairseq-generate
~~~~~~~~~~~~~~~~
Myle Ott's avatar
Myle Ott committed
44
45
46
47
48
.. automodule:: generate

    .. argparse::
        :module: fairseq.options
        :func: get_generation_parser
Myle Ott's avatar
Myle Ott committed
49
        :prog: fairseq-generate
Myle Ott's avatar
Myle Ott committed
50
51


Myle Ott's avatar
Myle Ott committed
52
.. _fairseq-interactive:
Myle Ott's avatar
Myle Ott committed
53

Myle Ott's avatar
Myle Ott committed
54
55
fairseq-interactive
~~~~~~~~~~~~~~~~~~~
Myle Ott's avatar
Myle Ott committed
56
57
58
59
60
.. automodule:: interactive

    .. argparse::
        :module: fairseq.options
        :func: get_interactive_generation_parser
Myle Ott's avatar
Myle Ott committed
61
        :prog: fairseq-interactive
Myle Ott's avatar
Myle Ott committed
62
63


Myle Ott's avatar
Myle Ott committed
64
.. _fairseq-score:
Myle Ott's avatar
Myle Ott committed
65

Myle Ott's avatar
Myle Ott committed
66
67
fairseq-score
~~~~~~~~~~~~~
Myle Ott's avatar
Myle Ott committed
68
69
70
.. automodule:: score

    .. argparse::
Myle Ott's avatar
Myle Ott committed
71
        :module: fairseq_cli.score
Myle Ott's avatar
Myle Ott committed
72
        :func: get_parser
Myle Ott's avatar
Myle Ott committed
73
        :prog: fairseq-score
Myle Ott's avatar
Myle Ott committed
74
75


Myle Ott's avatar
Myle Ott committed
76
.. _fairseq-eval-lm:
Myle Ott's avatar
Myle Ott committed
77

Myle Ott's avatar
Myle Ott committed
78
79
fairseq-eval-lm
~~~~~~~~~~~~~~~
Myle Ott's avatar
Myle Ott committed
80
81
82
83
84
.. automodule:: eval_lm

    .. argparse::
        :module: fairseq.options
        :func: get_eval_lm_parser
Myle Ott's avatar
Myle Ott committed
85
        :prog: fairseq-eval-lm