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:

Getting Started

1. Join the Organization

Join hf-skills 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 — claude in your terminal
• Codex — codex CLI
• Gemini CLI — gemini in 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:

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. 🚀