๐ค Welcome to QANTA 2025 Quizbowl Arena! โโโ ๐ ๐ Leaderboard ๐
๐ฒ Create, play around, and submit your quizbowl agents.
๐ Register to participate in our QANTA 2025 Human-AI Quizbowl Competition.
๐ First time here? Check out the โ Help tab for a quick introduction and QANTA25 Documentation for detailed examples and tutorials on how to create and compete with your own QuizBowl agents.
๐คจ Facing any issues? Please contact us at qanta@googlegroups.com, or raise an issue on our GitHub repository. ย ๐ง๐ปโ๐ป Engagements? Join our Discord server for discussions and getting help.
Create a pipeline with the following input and output variables.
- Input Variables:
question_text
- Output Variables:
answer
,confidence
Model Outputs
Submission Name Guidelines
- Must start with a letter.
- Can only contain letters, numbers, underscores, and hyphens.
- Cannot contain white spaces or other special characters.
Create a pipeline with the following input and output variables.
- Input Variables:
leadin
,part
- Output Variables:
answer
,confidence
,explanation
Model Outputs
Submission Name Guidelines
- Must start with a letter.
- Can only contain letters, numbers, underscores, and hyphens.
- Cannot contain white spaces or other special characters.
Submit Your Hugging Face Pipeline Model
Welcome to the Hugging Face pipeline submission interface for the QANTA 2025 competition! This page allows you to submit your models for both Tossup and Bonus tasks.
General Requirements:
- Your model must be a public, non-gated repository on the Hugging Face Hub.
- Ensure your model can be loaded using the
pipeline()
function from thetransformers
library. - Adhere to the specified input/output formats for each task.
For help getting started, check out our Starter Code.
You can also refer to Hugging Face's custom pipeline creation guide for more information on how to create a custom pipeline.
Select the appropriate tab below based on the type of question your model is designed for.
๐๏ธ QuizBowl Tossup โ Submit your model
Tossup questions are individual questions progressively revealed where you need to provide an answer, a confidence score, and decide whether to buzz.
Pipeline Loading: Your model repository must be loadable with:
from transformers import pipeline
model = pipeline(task="quizbowl-tossup", model="<your-username/your-repo-name>")
Input:
The pipeline will receive a dictionary with the key question_text
(string) which contains the progressively revealed question so far.
{
"question_text": "In 1900, this city hosted a world's fair that introduced the public to the first escalator. Its famous tower, designed by Gustave Eiffel, was initially criticized by artists but is now a global icon. Name this European capital."
}
Output: Similar to our agents, the pipeline must return a dictionary with the following keys:
{
"answer": <str: concise answer>,
"confidence": <float: confidence score between 0.0 and 1.0>,
"buzz": <bool: True if your model decides to buzz in with the answer, False otherwise>
}
Enter your Hugging Face model repository ID (<your-username/your-repo-name>
) and a brief description below, then click "Submit".
๐ง QuizBowl Bonus โ Submit your model
Bonus questions consist of a lead-in paragraph followed by multiple parts. Your model will be called for each part.
Pipeline Loading: Your model repository must be loadable with:
from transformers import pipeline
model = pipeline(task="quizbowl-bonus", model="<your-username/your-repo-name>")
Input: The pipeline will receive a dictionary with two keys:
leadin
(str): The introductory paragraph for the bonus question.part
(str): The specific part of the bonus question to answer.
{
"leadin": "This author wrote about a young wizard attending a magical school.",
"part": "For 10 points, name this author."
}
Output: Similar to our agents, the pipeline must return a dictionary with the following keys for each part:
{
"answer": <str: concise answer to the part>,
"confidence": <float: confidence score between 0.0 and 1.0>,
"explanation": <str: brief explanation (<=30 words) for your answer (useful for human collaboration)>
}
Enter your Hugging Face model repository ID (<your-username/your-repo-name>
) and a brief description below, then click "Submit".
Quick Start
- Choose between Tossup or Bonus mode
- Design your pipeline
- Test on example questions
- Submit for evaluation
Competition Rules
๐ง Tossup Questions
- Format: Individual questions progressively revealed. Questions get easier as they are revealed.
- Scoring:
- Correct early buzz: +10 points
- Incorrect early buzz: -5 points
- Correct after full read: +10 points
- Required Outputs:
answer
: Your predicted answerconfidence
: Score between 0-1buzzer
: When to attempt answering- Configure with confidence threshold (0.0-1.0)
- Optional token probability threshold for more control
- Combine thresholds using AND/OR logic (buzz when both/either condition met)
๐ Bonus Questions
- Format:
- Consists of a
leadin
paragraph that introduces the topic - Followed by three related
parts
(A, B, C) that test specific knowledge - Each part is worth 10 points
- Consists of a
- Scoring: +10 points per correct part (max 30)
- Required Outputs:
answer
: Your predicted answerconfidence
: Score between 0-1explanation
: Brief justification for human collaboration
Building Your First Pipeline
1. Simple Pipeline (Recommended for First Submission)
- Single model step
- Configure:
- Model selection
- Temperature (0.0-1.0)
- System prompt
- Required outputs
2. Using Demo Pipelines
- Load existing demo pipelines as starting points
- Modify configurations:
- Adjust model parameters
- Update system prompts
- Change confidence thresholds
- Add/remove pipeline steps
- Save modified versions as new pipelines
- Test changes incrementally
3. Testing Your Pipeline
- Select an example question
- For Tossup:
- Set buzz threshold (0.5-1.0)
- Enable early stopping
- Run and check:
- Answer accuracy
- Confidence scores
- Performance metrics
4. Evaluation
- Test on multiple questions
- Monitor:
- Accuracy
- Confidence patterns
- Response times
5. Submission
- Log in to Hugging Face
- Name your model
- Add description
- Submit for evaluation
Tips for Success
- Start with simple pipeline
- Test thoroughly before submission
- Use appropriate temperature (0.3-0.7 recommended)
- Monitor confidence scores
- Check example submissions
Need Help?
- Review example submissions
- Check documentation
- Contact support