transformers/templates/adding_a_new_example_script
Stas Bekman b0cbcdb05b
[logging] remove no longer needed verbosity override (#7100)
2020-09-15 04:01:14 -04:00
..
README.md [docs] Add integration test example to copy pasta template (#5961) 2020-07-22 12:48:38 -04:00
run_xxx.py [logging] remove no longer needed verbosity override (#7100) 2020-09-15 04:01:14 -04:00
utils_xxx.py Black 20 release 2020-08-26 17:20:22 +02:00

README.md

How to add a new example script in 🤗Transformers

This folder provide a template for adding a new example script implementing a training or inference task with the models in the 🤗Transformers library. Add tests!

These folder can be put in a subdirectory under your example's name, like examples/deebert.

Best Practices:

  • use Trainer/TFTrainer
  • write an @slow test that checks that your model can train on one batch and get a low loss.
    • this test should use cuda if it's available. (e.g. by checking transformers.torch_device)
  • adding an eval_xxx.py script that can evaluate a pretrained checkpoint.
  • tweet about your new example with a carbon screenshot of how to run it and tag @huggingface