Spaces:

build-small-hackathon
/

README

Running

App Files Files Community

ysharma HF Staff commited on 20 days ago

Commit

c968bcc

verified ·

1 Parent(s): 0b61f0c

Update README.md

Browse files

Files changed (1) hide show

README.md +45 -212

README.md CHANGED Viewed

@@ -9,286 +9,119 @@ pinned: false
 <div align="center">
-<sub><i>~ a hackathon for small things ~</i></sub>
-# Build &nbsp;·&nbsp; *Small.*
-#### A two-week hackathon for tiny weights, big ideas, and the things you can build close to home.
-Hosted by **Gradio** &nbsp;✦&nbsp; **Hugging Face**
-`Two tracks` &nbsp;·&nbsp; `Models ≤ 22GB` &nbsp;·&nbsp; `Built on Gradio` &nbsp;·&nbsp; `Open to everyone`
-</div>
----
-<div align="center">
-### *The internet is full of giant models doing giant things.*
-### *This isn't that.*
 </div>
-For two weeks, 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.
----
-<div align="center">
-<sub><i>~ choose your path ~</i></sub>
-## Two Tracks.
-</div>
 <table>
 <tr>
 <td width="50%" valign="top">
-### 🏡 &nbsp; Backyard AI
-<sub>*Chapter One*</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>**JUDGING CRITERIA**</sub>
-✦&nbsp; The problem is specific and real (not invented for the demo)
-✦&nbsp; The person it was built for actually used it
-✦&nbsp; Honest fit between problem, solution, and the small-model constraint
-✦&nbsp; Polish and craft of the Gradio app
 </td>
 <td width="50%" valign="top">
-### 🍄 &nbsp; *An Adventure in Thousand Token Wood*
-<sub>*Chapter Two*</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>**JUDGING CRITERIA**</sub>
-✦&nbsp; Genuinely delightful — would you show a friend?
-✦&nbsp; The AI is load-bearing for the experience
-✦&nbsp; Originality of concept (we've seen the chatbot)
-✦&nbsp; Polish and craft of the Gradio app
 </td>
 </tr>
 </table>
----
-<div align="center">
-<sub><i>~ rules of the land ~</i></sub>
-## The Constraints.
-</div>
 <table>
 <tr>
-<td width="33%" align="center" valign="top">
-### ①
-#### Small Models Only
-Any model that fits inside **22 GB** of memory.
-<sub>*↳ pending team sign-off*</sub>
 </td>
-<td width="33%" align="center" valign="top">
-### ②
-#### Built on Gradio
-Your app must be a Gradio app, hosted as a Hugging Face Space.
 </td>
-<td width="33%" align="center" valign="top">
-### ③
-#### Show, Don't Tell
-A short demo video and a social-media post about your project are part of the submission.
 </td>
 </tr>
 </table>
----
-<div align="center">
-<sub><i>~ getting started ~</i></sub>
-## How It Works.
-</div>
 <table>
 <tr>
-<td width="25%" valign="top">
-### *1.*
-#### Register
-Join this Hugging Face org. That's your ticket in — no application, no waitlist.
-</td>
-<td width="25%" valign="top">
-### *2.*
-#### Find Your People
-Hop into the Gradio Discord channel. Office hours, AMAs, and teammates live there.
-</td>
-<td width="25%" valign="top">
-### *3.*
-#### Build &amp; Ship
-Build your Gradio app and host it as a Space under this org during the hack window.
-</td>
-<td width="25%" valign="top">
-### *4.*
-#### Submit
-Drop your **Space link**, a short **demo video**, and a **social post** by the deadline.
-</td>
 </tr>
 </table>
----
 <div align="center">
-<sub><i>~ extra credit ~</i></sub>
-## Bonus Quests.
-*None of these are required. Each one bumps you up the leaderboard.*
-*Stack them like badges on a scout sash.*
 </div>
 <table>
 <tr>
-<td width="33%" valign="top">
-#### 🔌 &nbsp; *Off the Grid*
-No cloud APIs. The whole thing runs on the model in front of you.
-</td>
-<td width="33%" valign="top">
-#### 🎯 &nbsp; *Well-Tuned*
-Your app uses a fine-tuned model you've published on Hugging Face.
-</td>
-<td width="33%" valign="top">
-#### 🎨 &nbsp; *Off-Brand*
-A custom frontend that pushes past the default Gradio look.
-</td>
 </tr>
 <tr>
-<td width="33%" valign="top">
-#### 🦙 &nbsp; *Llama ChamPion*
-Your model runs through the llama.cpp runtime.
-</td>
-<td width="33%" valign="top">
-#### 📡 &nbsp; *Sharing is Caring*
-You shared your agent trace on the Hub.
-</td>
-<td width="33%" valign="top">
-#### 📓 &nbsp; *Field Notes*
-You wrote a blog post or report about what you built and what you learned. <sub>*tentative*</sub>
-</td>
 </tr>
 </table>
----
 <div align="center">
-<sub><i>~ when ~</i></sub>
-## Timeline.
 </div>
-|  | When | What |
 |:---:|:---|:---|
-| ● | *Week of [date TBD]* | **Registration opens** — sign up on the org, join Discord, start sketching ideas |
-| ● | *[date TBD]* | **Hack window begins** — two weeks to build, ship, and demo |
-| ● | *Mid-window* | **Live AMA + office hours** — ask the Gradio team anything |
-| ● | *[date TBD]* | **Submissions close** — Space, demo video, social post locked in |
-| ● | *[date TBD]* | **Winners announced** — per track, plus bonus-quest leaderboard |
----
 <div align="center">
 ## Build something *small.*
-*Two weeks. Two tracks. The model on your laptop. The neighbor next door.*
-*Let's make some little things.*
-### → &nbsp; [**Register on Hugging Face**](#) &nbsp; ←
-</div>
----
-<div align="center">
-<sub>**HOSTED BY · SPONSORED BY**</sub>
-**Gradio** &nbsp;·&nbsp; **Hugging Face** &nbsp;·&nbsp; *[ Sponsor TBD ]* &nbsp;·&nbsp; *[ Sponsor TBD ]*
-<br>
-<sub>Made with care by the Gradio team — questions? <a href="#">Find us on Discord</a></sub>
 </div>

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