AdapterHub

Website   •   Documentation   •   Library

You have just found "the Hub", the central GitHub repository collecting all adapter modules available via the AdapterHub platform.

📍 If you're here because you would like to add you own adapter to AdapterHub: Great! This is exactly the place to go! Refer to our documentation on how to get started.

🔎 If you're searching for the code of AdapterHub: Please go to https://github.com/adapter-hub/adapter-transformers.

❓ If you're here but don't know what all of the above is about: No problem! Check out our website at https://adapterhub.ml and our documentation at https://docs.adapterhub.ml to learn about AdapterHub and to get started.

Structure of this Repository

This repository is divided into the following subfolders:

• TEMPLATES contains templates for all different YAML info cards in this repository. We highly recommend you to use one of the available templates when adding your adapter, architecture, task etc. Auto-generated, do not modify anything here!

• adapter_types contains info cards for all types of adapters supported by our framework

• adapters is the place where all adapter info cards should go

• architectures contains info cards for all available adapter architectures. Add your own architecture here!

• dist contains generated files for adapters and architectures. Auto-generated, do not modify anything here!

• scripts contains script for validating the submitted adapters and info cards

• subtasks contains info cards for all available subtasks

• tasks contains info cards for all available tasks

How To Contribute

Refer to the step-by-step guides in our documentation on how to contribute your adapters to the Hub.

Our template files are a good way to get started with any contribution to this repo.

AdapterHub CLI

The AdapterHub CLI provides command-line tools to help you contributing to the Hub, such as packaging adapters or validating filled-out yaml files.

To install the CLI from the cloned repository, you can run the following in this folder:

pip install -U ./scripts/.

Alternatively, you can install the CLI using:

pip install -U git+https://github.com/adapter-hub/hub.git#subdirectory=scripts

Now you can use the pack pack command to interactively prepare your adapters for upload and submission to the Hub:

adapter-hub-cli pack <folder_with_models_or_adapters>

To validate yaml files, run:

adapter-hub-cli check path/to/adapter.yaml

Read more about the AdapterHub CLI in the documentation.

Citation

Please cite our paper when using AdapterHub for your work:

@inproceedings{pfeiffer2020AdapterHub,
    title={{AdapterHub: A Framework for Adapting Transformers}},
    author={Jonas Pfeiffer and
            Andreas R\"uckl\'{e} and
            Clifton Poth and
            Aishwarya Kamath and
            Ivan Vuli\'{c} and
            Sebastian Ruder and
            Kyunghyun Cho and
            Iryna Gurevych},
    booktitle={Proceedings of the 2020 Conference on Empirical Methods in Natural Language Processing (EMNLP 2020): Systems Demonstrations},
    year={2020},
    address = "Online",
    publisher = "Association for Computational Linguistics",
    url = "https://www.aclweb.org/anthology/2020.emnlp-demos.7",
    pages = "46--54",
}