title: README
emoji: 🐠
colorFrom: yellow
colorTo: gray
sdk: static
pinned: false
Humanity's Last Hackathon (of 2025)
Welcome to our hackathon!
Whether you’re a tooled up ML engineer, a classicist NLP dev, or an AGI pilled vibe coder, this hackathon is going to be hard work! We’re going to take the latest and greatest coding agents and use them to level up open source AI. After all, why use December to relax and spend time with loved ones, when you can solve AI for all humanity? Jokes aside, this hackathon is not about learning skills from zero or breaking things down in their simplest components. It’s about collaborating, shipping, and making a difference for the open source community.
What We're Building
Over four weeks, we're using coding agents to level up the open source AI ecosystem:
- Week 1 — Evaluate models and build a distributed leaderboard
- Week 2 — Create high-quality datasets for the community
- Week 3 — Fine-tune and share models on the Hub
- Week 4 — Sprint to the finish line together
Every contribution earns XP. Top contributors make the leaderboard. Winners get prizes!
Here's the schedule:
| Date | Event | Link |
|---|---|---|
| Dec 2 (Mon) | Week 1 Quest Released | Evaluate a Hub Model |
| Dec 4 (Wed) | Livestream 1 | TBA |
| Dec 9 (Mon) | Week 2 Quest Released | Publish a Hub Dataset |
| Dec 11 (Wed) | Livestream 2 | TBA |
| Dec 16 (Mon) | Week 3 Quest Released | Supervised Fine-Tuning |
| Dec 18 (Wed) | Livestream 3 | TBA |
| Dec 23 (Mon) | Week 4 Community Sprint | TBA |
| Dec 31 (Tue) | Hackathon Ends | TBA |
Getting Started
1. Join the Organization
Join humanitys-last-hackathon on Hugging Face. This is where your contributions will be tracked and updated on the leaderboard.
2. Set Up Your Coding Agent
Use whatever coding agent you prefer:
- Claude Code —
claudein your terminal - Codex —
codexCLI - Gemini CLI —
geminiin your terminal - Cursor / Windsurf — IDE-based agents
- Open source — aider, continue, etc.
The skills in this repo work with any agent that can read markdown instructions and run Python scripts. To install the skills, follow the instructions in the README.
3. Get Your HF Token
Most quests require a Hugging Face token with write access:
# mac/linux
curl -LsSf https://hf.co/cli/install.sh | bash
# windows
powershell -ExecutionPolicy ByPass -c "irm https://hf.co/cli/install.ps1 | iex"
# Login (creates/stores your token)
hf auth login
This will set your HF_TOKEN environment variable.
4. Clone the Skills Repo
git clone https://github.com/huggingface/skills.git
cd skills
Point your coding agent at the relevant configuration. Check the README for instructions on how to use the skills with your coding agent.
Your First Quest
Week 1 is live! Head to 02_evaluate-hub-model.md to start evaluating models and climb the leaderboard.
Earning XP
Each quest has three tiers:
| Tier | What it takes | XP |
|---|---|---|
| 🐢 | Complete the basics | 50-75 XP |
| 🐕 | Go deeper with more features | 100-125 XP |
| 🦁 | Ship something impressive | 200-225 XP |
You can complete multiple tiers, and you can complete the same quest multiple times with different models/datasets/spaces.
Getting Help
- Discord — Join the Hugging Face Discord for real-time help
- Livestreams — Weekly streams with walkthroughs and Q&A
- Issues — Open an issue in this repo if you're stuck
To join the Hackathon, join the organization on the hub and setup your coding agent.
Ready? Let's ship some AI. 🚀