README.md

---
title: README
emoji: 🏃
colorFrom: green
colorTo: indigo
sdk: static
pinned: false
---

<div align="center">

<img src="./assets/banner.svg" alt="Build Small — a small hackathon by Gradio &amp; Hugging Face" width="100%"/>

<sub><b>HOSTED BY</b> &nbsp;Gradio &nbsp;·&nbsp; Hugging Face &nbsp;&nbsp;&nbsp;<b>SPONSORED BY</b> &nbsp;<i>[ TBD ]</i></sub>

### *The internet is full of giant models doing giant things. This isn't that.*

</div>

For two weekends, we want to see what you can do with **small models**, **tight constraints**, and **care for the people right around you**. Build for one neighbor. Build something that runs on the laptop you already own. Build something a child could love. Pick a track, ship a Gradio app, and tell us a story.

## Two Tracks

<table>
<tr>
<td width="50%" valign="top">

<img src="./assets/track-backyard.svg" alt="Backyard AI" width="100%"/>

#### 🏡 &nbsp; Backyard AI &nbsp; <sub><i>Chapter One</i></sub>

***Solve a real problem for someone you actually know.*** Pick a person — a neighbor, a parent, a small business owner on your street — and build something that makes their day measurably better. Walk over. Watch them use it. The closer the problem, the better the project.

<sub>**JUDGED ON** &nbsp;·&nbsp; problem is specific and real &nbsp;·&nbsp; the person actually used it &nbsp;·&nbsp; honest fit between problem, solution, and the small-model constraint &nbsp;·&nbsp; polish of the Gradio app</sub>

</td>
<td width="50%" valign="top">

<img src="./assets/track-wood.svg" alt="Thousand Token Wood" width="100%"/>

#### 🍄 &nbsp; *An Adventure in Thousand Token Wood* &nbsp; <sub><i>Chapter Two</i></sub>

***Build something delightful that wouldn't exist without AI.*** Wander somewhere weirder. A toy, a tiny game, a strange interactive story, an art experiment that surprises you. The AI should be doing the fun thing — not just helping you build it. Strange is good. Joyful is the bar.

<sub>**JUDGED ON** &nbsp;·&nbsp; genuinely delightful (would you show a friend?) &nbsp;·&nbsp; AI is load-bearing for the experience &nbsp;·&nbsp; originality of concept &nbsp;·&nbsp; polish of the Gradio app</sub>

</td>
</tr>
</table>

## The Constraints &nbsp; · &nbsp; How It Works

<table>
<tr>
<td width="33%" valign="top">

**① &nbsp; Small Models Only** — any model that fits inside **22 GB** of memory.

</td>
<td width="33%" valign="top">

**② &nbsp; Built on Gradio** — your app must be a Gradio app, hosted as a Hugging Face Space.

</td>
<td width="33%" valign="top">

**③ &nbsp; Show, Don't Tell** — a short demo video and a social-media post are part of the submission.

</td>
</tr>
</table>

<table>
<tr>
<td width="25%" valign="top"><b>1. Register</b> — join this org. No application, no waitlist.</td>
<td width="25%" valign="top"><b>2. Find your people</b> — hop into the Gradio Discord. Office hours, AMAs, teammates live there.</td>
<td width="25%" valign="top"><b>3. Build &amp; ship</b> — build your Gradio app and host it as a Space under this org.</td>
<td width="25%" valign="top"><b>4. Submit</b> — drop your <b>Space link</b>, a <b>demo video</b>, and a <b>social post</b> by the deadline.</td>
</tr>
</table>

## Bonus Quests

<div align="center">
<img src="./assets/merit-badges.svg" alt="Six earnable merit badges" width="92%"/>
</div>

*None required. Each one bumps you up the leaderboard. Stack them like badges on a scout sash.*

<table>
<tr>
<td width="33%" valign="top"><b>🔌 &nbsp; <i>Off the Grid</i></b><br/>No cloud APIs. The whole thing runs on the model in front of you.</td>
<td width="33%" valign="top"><b>🎯 &nbsp; <i>Well-Tuned</i></b><br/>Your app uses a fine-tuned model you've published on Hugging Face.</td>
<td width="33%" valign="top"><b>🎨 &nbsp; <i>Off-Brand</i></b><br/>A custom frontend that pushes past the default Gradio look.</td>
</tr>
<tr>
<td width="33%" valign="top"><b>🦙 &nbsp; <i>Llama Champion</i></b><br/>Your model runs through the llama.cpp runtime.</td>
<td width="33%" valign="top"><b>📡 &nbsp; <i>Sharing is Caring</i></b><br/>You shared your agent trace on the Hub.</td>
<td width="33%" valign="top"><b>📓 &nbsp; <i>Field Notes</i></b><br/>You wrote a blog post or report about what you built. <sub><i>tentative</i></sub></td>
</tr>
</table>

## Timeline

<div align="center">
<img src="./assets/timeline-map.svg" alt="A hand-drawn map of the hackathon timeline" width="88%"/>
</div>

| | When | What |
|:---:|:---|:---|
| **I.** | *Week of [date TBD]* | **Registration opens** — sign up, join Discord, start sketching |
| **II.** | *[date TBD]* | **Hack window begins** — two weekends to build, ship, and demo |
| **III.** | *Mid-window* | **Live AMA + office hours** — ask the Gradio team anything |
| **IV.** | *[date TBD]* | **Submissions close** — Space, demo video, social post locked in |
| **V.** | *[date TBD]* | **Winners announced** — per track, plus bonus-quest leaderboard |

<div align="center">

## Build something *small.*

*Two weekends. Two tracks. The model on your laptop. The neighbor next door.*

### → &nbsp; [**Register on Hugging Face**](#) &nbsp; ← <sub>*↳ placeholder link for now*</sub>

<sub>Made with care by the Gradio team &nbsp;·&nbsp; questions? <a href="#">Find us on Discord</a> &nbsp;·&nbsp; <i>vol. III · mmxxvi</i></sub>

</div>