Docs

A unified platform for sharing, training and evaluating dialog models across many tasks.

Multitask training over many datasets at once.

Supports dialog models in PyTorch, Tensorflow, Theano, Torch, and other frameworks.

Seamless integration of Amazon Mechanical Turk for data collection, training and human evaluation.

See Examples Fork me on GitHub

What's New

2017-08-15: New task added: CLEVR

2017-07-20: ParlAI Request For Proposals: Funding university teams - 7 awards are available - deadline Aug 25

2017-07-20: added building an (seq2seq) agent tutorial

2017-07-12: Several new tasks added: MS Marco, TriviaQA, InsuranceQA, personalized-dialog and MNIST_QA

2017-06-27: ExecutableWorld class for interactive worlds with dialog

2017-06-21: MTurk now supports multiple assignments per HIT

2017-06-20: updated MTurk tutorial to reflect new design

2017-06-20: MTurk now uses general world and agent classes

2017-06-16: added Creating a New Task tutorial

2017-05-31: added Seq2Seq model

2017-05-30: added interactive mode with local human agent

2017-05-22: added MTurk tutorial

2017-05-14: added basic tutorial

2017-05-15: ParlAI press: TechCrunch, CNBC, The Verge, Scientific American, Engadget, Venture Beat, Wired, MIT Technology review.

2017-05-12: added VQA V2.0 and Visual Dialog V0.9 tasks

2017-05-01: ParlAI released!

Get Started

Check out our GitHub repository:

Run this command:
git clone https://github.com/facebookresearch/ParlAI.git
cd ParlAI; python setup.py develop

Examples

Display 10 random examples from task 1 of the "1k training examples" bAbI task:

Run this command:
python examples/display_data.py -t babi:task1k:1

Displays 100 random examples from multitasking on the bAbI task and the SQuAD dataset at the same time:

Run this command:
python examples/display_data.py -t babi:task1k:1,squad -n 100

Evaluate an IR baseline model on the validation set of the Movies Subreddit dataset:

Run this command:
python examples/eval_model.py -m ir_baseline -t "#moviedd-reddit" -dt valid

Display the predictions of that same IR baseline model:

Run this command:
python examples/display_model.py -m ir_baseline -t "#moviedd-reddit" -dt valid

Train a simple cpu-based memory network on the "10k training examples" bAbI task 1 with 8 threads (python processes) using Hogwild (requires zmq and Lua Torch):

Run this command:
python examples/memnn_luatorch_cpu/full_task_train.py -t babi:task10k:1 -nt 8

Trains an attentive LSTM model on the SQuAD dataset with a batch size of 32 examples (pytorch and regex):

Run this command:
python examples/drqa/train.py -t squad -bs 32

For more examples, please read our tutorial. To learn more about ParlAI, click here.