A Repository of Community-Driven Natural Instructions
TLDR; this repository maintains a community effort to create a large collection of tasks and their natural language definitions/instructions. We're looking for more contributions to make this data bigger!
Background
Why define tasks in natural language?
While the current dominant paradigm (supervised learning with task-specific labeled examples) has been successful in building task-specific models, such models can't generalize to unseen tasks; for example, a model that is supervised to solve questions cannot solve a classification task. We hypothesize that a model equipped with understanding and reasoning with natural language instructions should be able to generalize to any task that can be defined in terms of natural language.
Any empirical evidence that this might be true?
In our earlier effort, we built a smaller data (61 tasks) and observed that language models benefit from language instructions, i.e., their generalization to unseen tasks when they were provided with more instructions.
Also, generalization to unseen tasks improves as the model is trained on more tasks.
Why build this dataset?
We believe that our earlier work is just scratching the surface and there is probably so much that be studied in this setup. We hope to put together a much larger dataset that cover a wider range of reasoning abilities. We believe that this expanded dataset will serve as a useful playground for the community to study and build the next generation of AI/NLP models.
Task definitions
Each consists of input/output. For example, think of the task of sentiment classification:
- Input:
I thought the Spiderman animation was good, but the movie disappointed me. - Output:
Mixed
Here is another example from the same task:
- Input:
The pumpkin was one of the worst that I've had in my life. - Output:
Negative
Additionally, each ask contains a task definition:
Given a tweet, classify it into one of 4 categories: Positive, Negative, Neutral, or Mixed.
Overall, each tasks follows this schema:
Or if you're comfortable with json files, here is how it would look like:
{
"Definition": "",
"Positive Examples": [ { "input": "", "output": "", "explanation": ""} ],
"Negative Examples": [ { "input": "", "output": "", "explanation": ""} ],
"Instances": [ { "input": "", "output": [""]} ],
}
How to contribute
We would appreciate any external contributions!
- All submissions must be submitted via Github pull requests. These submissions will undergo a review before being merged.
- Each task must contain contain a
.jsonfile that contains the task content. You can look inside thetasks/directory for several examples.- Make sure that your json is human readable (use proper indentation; e.g., in Python:
json.dumps(your_json_string, indent=4)) - Make sure that you json file is not bigger than 50MB.
- Make sure your task has no more 6.5k instances (input/output pairs).
- Make sure to number your task json correctly (Look at the task number in the latest pull request, task number in your submission should be the next number). Make sure to include the source dataset name and the task category name while creating the json file name. You can use this format: taskabc__.json E.g. in task001_quoref_question_generation.json, the source dataset is 'quoref' and the task category is 'question generation. Note that, source need not necesserily be a dataset and can be a website e.g. leetcode. Finally, if you have created the json without any reference, use 'synthetic' in place of source.
- Make sure to create a pull request after creating all possible tasks from a dataset. You should have one pull request per dataset.
- If you're building your tasks based existing datasets and their crowdsourcing templates, see these guidelines.
- Make sure that your json is human readable (use proper indentation; e.g., in Python:
- Add your task to our list of tasks.
- To make sure that your addition is formatted correctly, run the tests:
> python src/test_all.py
If you have any questions or suggestions, please use the issues feature.
Frequently Asked Questions
Can I submit non-English tasks?
Yes! We welcome submission from any of the languages.
Can I create tasks without using crowdsourcing templates?
Yes! just make sure that the quality of instructions is good enough for a human to understand the task just based on instructions. You can take a different route than the guidelines.
What is the minimun number of instances I can have in my task?
Anything north of 100 is a safe number. The more, the merrier! Also, you should not have more than 6500 instances.
What do you mean by "meaningful contribution"?
If you're among top k contributors (say, k=25), or if you have contributed at least l tasks (say, l=10). Depending on the overall contributions, we will adjust these constants so that the number of authors don't exeed m (say, m=35).
My commits are not tied to my Github profie; Github does not show all my contributions.
Make sure that your email is set in your git environment and it is also mentioned in your github profile. See this and this.
18 Aug 04, 2022
116 Dec 20, 2022
381 Dec 22, 2022
165 Oct 25, 2022
6 Aug 25, 2022
290 Dec 25, 2022
81 Dec 22, 2022
70 Jan 02, 2023
371 Jan 06, 2023
43 Oct 01, 2022
7.4k Jan 04, 2023
287 Jan 06, 2023
3 Dec 01, 2022
23 Dec 07, 2022
52 Nov 20, 2022
101 Dec 05, 2022
19 Dec 12, 2022
118 Dec 21, 2022
2 Jul 16, 2022
39 Dec 16, 2022