🤖 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
For multimodal questions, images are attached automatically—no separate input.
- 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.
Multimodal: Evaluation may include questions with images. The input dictionary may contain an optional images key (list of image paths or PIL Images) in addition to the text fields below. Your pipeline can handle text-only inputs when images is absent or empty.
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 thetransformerslibrary. - 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 at least question_text (string). For multimodal evaluation, it may also include images (list of image paths or PIL Images).
{
"question_text": "In 1900, this city hosted a world's fair...",
"images": [] # optional; list of images when the question includes figures
}
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 at least leadin (str) and part (str). For multimodal evaluation, it may also include images (list of image paths or PIL Images for leadin + part).
{
"leadin": "This author wrote about a young wizard...",
"part": "For 10 points, name this author.",
"images": [] # optional; list of images when the bonus includes figures
}
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 (text-only or with images; the app supports both)
- Submit for evaluation
Competition Rules
🧠 Tossup Questions
- Format: Individual questions progressively revealed (text and optionally images). 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
leadinparagraph 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 (may be text-only or include images; images are sent to the model automatically when present)
- 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