ysharma HF Staff commited on
Commit
727f334
Β·
verified Β·
1 Parent(s): 283db79

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +323 -131
README.md CHANGED
@@ -7,16 +7,21 @@ sdk: static
7
  pinned: true
8
  ---
9
 
10
-
11
  # πŸ€– Agents & MCP Hackathon - Winter 2025 πŸš€
12
 
13
  ![Gradio Agents & MCP Hackathon - Winter 25 - Banner](https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/piIiwWWeO6RmTQftH1c0V.png)
14
 
15
- **The MCP revolution continues.** The June 2025 version of Hackathon was a huge success with over 4200 registrations, 1 Millions+ free API credits for participants, and $16000+ awards in cash.
16
- Six months later, we are bringing you the next edition of this world event! When we launched this hackahon in June 2025, MCP was experimental. Six months later, OpenAI, Microsoft, and Google have adopted it. The revolution we started is now mainstreamβ€”be part of the second wave.
 
 
 
 
 
 
 
17
 
18
- <br>**Note:** To have your entry considered for prizes, you **MUST** be a member of this organization and submit your apps here.
19
- <br>**Join our [Discord Community](https://discord.gg/Qe3jMKVczR) channel `gradio-hackathon-nov-2025πŸ†`** for active support during the hackathon.
20
 
21
  <div style="text-align: center; margin: 30px 0;">
22
  <a href="https://huggingface.co/spaces/ysharma/gradio-hackathon-registration-winter25"
@@ -35,214 +40,401 @@ Six months later, we are bringing you the next edition of this world event! When
35
  </a>
36
  </div>
37
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
38
 
39
  ## 🌟 Welcome to Agents & MCP Hackathon: Winter 2025
40
 
41
- Join us for the definitive AI agents and Model Context Protocol (MCP) development eventβ€”now bigger, better, and more accessible than ever. Build cutting-edge agentic applications powered by Gradio 6, leverage vibe coding to accelerate development, and compete for over $50,000 in cash prizes and credits.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
42
 
43
- **What's New This Year:**
44
  - **Powered by Gradio 6** with enhanced mobile capabilities and visual editing
45
  - **3 full weekends** to build (Nov 14 - Nov 30)
46
- - **Mobile-first AI track** to showcase gradio's latest mobile-friendly features
47
- - **Vibe coding friendly** β€” build faster with gradio vibe editor
48
  - **Social amplification** β€” share your work, gain visibility
 
49
 
50
- **Key Details**
51
- **πŸ“… Dates:** November 14 - November 30, 2025 (17 days, 3 weekends)
52
- **πŸ“ Location:** Global & Online
53
- **πŸ† Prizes: $15,000+ in cash prizes and credits**
54
- **🎁 FREE API Credits coming soon**
55
 
56
  ## πŸ’° Why MCP Matters More Than Ever
57
 
58
- Since our June'25 hackathon:
59
- - **OpenAI officially adopted MCP, later announced Apps SDK built on top of it** ([DevDay 2025](https://openai.com/index/introducing-apps-in-chatgpt/))
60
- - **Microsoft integrated MCP into Windows 11** ([Build 2025](https://blogs.windows.com/windowsexperience/2025/05/19/securing-the-model-context-protocol-building-a-safer-agentic-future-on-windows/))
61
- - **Google DeepMind joined the ecosystem** ([Demis Hassabis's tweet](https://x.com/demishassabis/status/1910107859041271977))
62
 
63
- MCP is no longer experimentalβ€”it's the foundation of modern agentic AI. This is your opportunity to build on the protocol that's reshaping how AI systems connect to the world.
64
 
65
- ## πŸ’Έ Sponsors & Credits
 
 
66
 
67
- **API & Compute Credits** (Details announced soon):
68
- - We are securing API credits for participants from major AI providers
69
- - Access to latest and strongest LLMs from major providers
70
 
71
- **Confirmed & Pending Sponsors:** Announcements rolling out weekly. Follow [@Gradio](https://x.com/Gradio) for the latest.
72
 
73
- ## πŸ“ How to Participate
74
 
75
- 1. **Join our Organization**: Click "Request to join this org" at the top right
76
- 2. **Register**: Complete the [registration form](https://huggingface.co/Agents-MCP-Hackathon-Winter25) (placeholder link)
77
- 3. **Build Your Project**: Choose your track and start creating (Nov 14)
78
- 4. **Share on Social**: Post about your project on X, LinkedIn, or other platforms
79
- 5. **Submit**: Push your [Space](https://huggingface.co/spaces/) to this organization before **November 30, 2025, 11:59 PM UTC**
80
 
81
- **NEW REQUIREMENT:** Include a link to your social media post (X, LinkedIn, etc.) about your project in your Space README. This helps amplify community work and qualifies you for Community Choice awards.
82
 
83
- ## πŸ› οΈ Hackathon Tracks
 
 
84
 
85
  ### πŸ”§ Track 1: MCP Tools & Servers
86
- Build MCP servers using Gradio 6 that extend LLM capabilities. [Any Gradio app can be an MCP server](https://huggingface.co/blog/gradio-mcp)β€”create tools for data analysis, API integrations, specialized workflows, or novel capabilities that make AI agents more powerful.
87
 
88
- **What to Build:** MCP servers, tool integrations, protocol extensions, multi-tool systems
89
-
90
- ### πŸ€– Track 2: Agentic Applications
91
- Create complete AI agent applications that showcase autonomous reasoning, planning, and execution. Use MCP tools, vibe coding, or traditional developmentβ€”whatever brings your agent vision to life. This is the showcase for production-ready agentic systems.
92
- This track has the following three categories:
93
- - Productivity/Workflow automation apps
94
- - Multimodal apps
95
- - Gaming apps
96
-
97
- **What to Build:** Full-stack agent apps, multi-agent systems, autonomous workflows, AI assistants
98
 
 
 
 
 
 
99
 
100
- ## 🎁 Prize Structure (tentative)
101
 
102
- **Total Prize Pool: $15,000+ USD**
 
103
 
104
- ### MCP Track Prizes:
105
  - πŸ₯‡ **First Place:** $1,500 USD
106
  - πŸ₯ˆ **Second Place:** $500 USD
107
 
108
- ### Agent Track Prizes -- Three prizes in each of the three categories:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
109
  - πŸ₯‡ **First Place:** $2,500 USD
110
  - πŸ₯ˆ **Second Place:** $1,000 USD
111
  - πŸ₯‰ **Third Place:** $500 USD
112
 
113
- ### Special Awards:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
114
  - 🌟 **Community Choice Award:** $1,000 USD (most social engagement)
115
- - 🏒 **Sponsor Choice Awards:** (tentaitive / announced with sponsors)
116
- - πŸ€— **Hugging Face Merch:** For most _engaging_ participants and _community builders_
117
 
 
118
 
119
- ## πŸ—“οΈ Schedule
120
 
121
- ### Pre-Hackathon
122
- - **October 13 - November 13:** Sponsor announcements, content releases, registrations open
123
 
124
- ### Hackathon Period
125
- - **November 14 (Friday, 12:00 AM UTC):** Hackathon opens
126
- - **November 14/15:** Kickoff stream on YouTube (time TBA)
127
- - **November 17-28:** Office hours with Gradio team and sponsors
128
- - **November 30 (Saturday, 11:59 PM UTC):** Final submissions due
129
 
130
- ### Post-Hackathon
131
- - **December 1-14:** Judging period
132
- - **December 15:** Winners announcement and showcase
133
 
134
- ## πŸ’» Resources & Getting Started
135
 
136
- ### Technical Documentation
137
- - [Getting Started with MCP in Gradio](https://huggingface.co/blog/gradio-mcp)
138
- - [Gradio 6 Documentation](https://www.gradio.app/) (placeholder)
139
- - [Building Mobile-First AI Apps](https://github.com/gradio-app/gradio-mobile-app)
140
- - [Custom Components Guide](https://www.gradio.app/guides/custom-components-in-five-minutes)
141
- - [Vibe Coding with Gradio](https://www.youtube.com/watch?v=dis1BwDzmYs)
142
- - [Agent Development Patterns](https://www.gradio.app/guides/agents-and-tool-usage)
143
 
144
- ### Educational Content (tentative)
145
- - **Video Tutorials:** ...
146
- - **Blog Posts / Guides:** Case Studies from June Hackathon
147
- - **Office Hours:** Live sessions with experts (schedule announced soon)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
148
 
149
- ## 🎯 Submission Guidelines
 
 
150
 
151
- ### All Tracks - General Requirements:
152
- 1. Publish your project as a Hugging Face Space
153
- 2. Add the appropriate track tag to your Space `README.md`:
154
- - `"mcp-server-track"` for Track 1 ([see example](https://huggingface.co/spaces/ysharma/sample1-hackathon-space-submission/blob/main/README.md))
155
- - `"agent-app-track-productivity"`,`"agent-app-track-multimodal"`, or `"agent-app-track-game"` for Track 2 (see examples: [productivity category](https://huggingface.co/spaces/ysharma/sample2-hackathon-space-submission/blob/main/README.md), [multimodal category](https://huggingface.co/spaces/ysharma/sample3-hackathon-space-submission/blob/main/README.md), [game category](https://huggingface.co/spaces/ysharma/sample5-hackathon-space-submission/blob/main/README.md))
156
- - You can submit same app to multiple tracks. ([see example](https://huggingface.co/spaces/ysharma/sample4-hackathon-space-submission/blob/main/README.md))
157
- - You can submit multiple entries in the Hackathon
158
- 3. **Must include a link to your social media post** (X, LinkedIn, etc.) about your project
159
- 4. Include a small demo video (1-5 minutes) showing your project in action (see [example 1](https://huggingface.co/spaces/Agents-MCP-Hackathon/Sentinel_One/blob/main/README.md#welcome-to-our-submission-for-the-hugging-face-genai-agents--mcp-hackathonthis-project-showcases-a-multi-agent-system-powered-by-gradio-and-smolagents-designed-to-monitor-process-and-analyze-environmental-data-to-assess-climate-related-risks-and-provide-recommendations-link-to-demo--httpsyoutubealk_husrl4w), [example 2](https://huggingface.co/spaces/Agents-MCP-Hackathon/cs-agent/blob/main/README.md#%F0%9F%93%B9-preview), [example 3](https://huggingface.co/spaces/Agents-MCP-Hackathon/geocalc-mcp/blob/main/README.md#%F0%9F%8E%A5-demo-video))
160
- 5. All work must be original and created during the hackathon period (Nov 14-30)
161
 
162
- ### Track 1: MCP Tools & Servers
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
163
  - Must be a functioning MCP server built with Gradio
164
  - Include video showing integration with an MCP client (Claude Desktop, Cursor, etc.)
165
  - Document the tool's purpose, capabilities, and usage
166
 
167
- ### Track 2: Agentic Applications
168
  - Must demonstrate autonomous agent behavior (planning, reasoning, execution)
169
  - Can use MCP tools, custom tools, or external APIs
170
- - Bonus points for showcasing Context Engineering using gradio. More about Context Engineering - [one](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents), [two](https://blog.langchain.com/context-engineering-for-agents/), and [three](https://www.dbreunig.com/2025/07/24/why-the-term-context-engineering-matters.html)
 
171
  - Show clear user value and practical application
172
 
 
173
 
174
- ## πŸ… Judging Criteria (tentaive)
175
 
176
- Projects evaluated on:
177
- ...
 
 
 
 
 
 
 
 
 
178
 
179
  **Community Choice Award** based on:
180
  - Social media engagement (likes, shares, comments)
181
- - Space interactions on Hugging Face
182
- - Discord community engagement
183
 
184
- ## πŸ‘₯ Connect & Community
185
 
186
- - **Discord:** [Join #agents-mcp-hackathon-winter25πŸ†](https://discord.gg/YgswRqxQ)
187
- - **Twitter/X:** [@Gradio](https://x.com/gradio)
188
- - **LinkedIn:** [Gradio](https://www.linkedin.com/company/gradio/)
189
- - **YouTube:** [Subscribe for tutorials]() (placeholder)
190
 
191
- ## βš–οΈ Policies & Rules
 
192
 
193
- By participating, you agree to:
194
- - [Code of Conduct](https://huggingface.co/code-of-conduct)
195
- - [Submission Guidelines](#submission-guidelines)
196
- - [Intellectual Property Policy](https://huggingface.co/content-policy)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
197
 
198
- **Important:**
199
- - All submissions must be original work
200
- - Projects must be created between November 14-30, 2025
201
- - Open source licenses encouraged (MIT, Apache 2.0, etc.)
202
- - Participants retain IP rights to their work
203
- - By submitting, you grant Hugging Face/Gradio right to showcase your work
204
 
205
- ## ❓ FAQ
 
206
 
207
- **Q: I'm new to MCP. Can I still participate?**
208
- A: Absolutely! We provide comprehensive tutorials on MCP and will have office hours throughout to support the particiants. Track 2 and 3 don't necessarily require MCP knowledge.
209
 
210
- **Q: Can I use vibe coding tools like Bolt, Lovable, or Cursor?**
211
- A: Yes! Use any tools that help you build. We celebrate results, not just process.
212
 
213
- **Q: Do I need to build everything from scratch?**
214
- A: No. You can use existing libraries, frameworks, and tools. Just ensure your core contribution is original and created during the hackathon.
215
 
216
- **Q: Can I participate solo or do I need a team?**
217
- A: Both! Participate individually or in teams of 2-5 members.
218
 
219
- **Q: What if I participated in the June hackathon?**
220
- A: Welcome back! Build something new or significantly evolve your previous project. Previous winners are eligible.
221
 
222
- **Q: Is there a specific programming language requirement?**
223
- A: Gradio is Python-based, but you can integrate other languages/services as needed.
224
 
225
- **Q: How do I get help during the hackathon?**
226
- A: Discord support, office hours, documentation, and community help available throughout.
227
 
228
- **Q: Can I submit to multiple tracks?**
229
- A: Yes, go for it!
230
 
231
- **Q: What counts as "mobile-first" for Track 3?**
232
- A: Responsive design, touch optimization, mobile-appropriate interactions. Doesn't need to be a native appβ€”PWAs and responsive web apps qualify.
233
 
234
  ---
235
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
236
  ## πŸš€ From June to November: The Evolution
237
 
238
- **June 2025:** 4,200++ registrations, ~650 submissions, $1M++ in API/GPU Credits
239
- **November 2025:** Targeting 12,000 registrations, 3x the prizes, establishing the Gradio agents hackathon as a industry standard definitive event
 
240
 
241
  Join the community that launched the MCP developer movement. Build the future of agentic AI.
242
 
243
- **Registration opens: Coming Soon**
244
- **Building starts: November 14, 2025**
 
 
 
245
 
246
  ---
247
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
248
  *Questions? Reach out in [Discord](https://discord.gg/Qe3jMKVczR) or email: gradio-team@huggingface.co*
 
 
 
7
  pinned: true
8
  ---
9
 
 
10
  # πŸ€– Agents & MCP Hackathon - Winter 2025 πŸš€
11
 
12
  ![Gradio Agents & MCP Hackathon - Winter 25 - Banner](https://cdn-uploads.huggingface.co/production/uploads/60d2dc1007da9c17c72708f8/piIiwWWeO6RmTQftH1c0V.png)
13
 
14
+ <div align="center">
15
+
16
+ | πŸ“… Duration | πŸ’° Prize Pool | 🎯 Tracks | πŸ‘₯ Team Size | 🌍 Location |
17
+ |-------------|---------------|-----------|--------------|-------------|
18
+ | **Nov 14-30, 2025**<br>(17 days, 3 weekends) | **$15,000+ USD Cash Prizes**<br>+ Free API Credits | **2 Main Tracks**<br>4 Categories | **Solo or Teams of 2-5** | **Global & Online** |
19
+
20
+ </div>
21
+
22
+ ---
23
 
24
+ **The MCP revolution continues.** The June 2025 version of Hackathon was a huge success with over 4200 registrations, 1 Millions+ free API credits for participants, and $15000+ awards in cash. Six months later, we are bringing you the next edition of this world event! When we launched this hackathon in June 2025, MCP was experimental. Six months later, OpenAI, Microsoft, and Google have adopted it. The revolution we started is now mainstreamβ€”be part of the second wave.
 
25
 
26
  <div style="text-align: center; margin: 30px 0;">
27
  <a href="https://huggingface.co/spaces/ysharma/gradio-hackathon-registration-winter25"
 
40
  </a>
41
  </div>
42
 
43
+ > [!IMPORTANT]
44
+ > **To qualify for prizes, you MUST:**
45
+ > - βœ… Be a member of this organization (click "Request to join this org" above)
46
+ > - βœ… Submit your apps to this organization
47
+ > - βœ… Include appropriate track tags in your Space README
48
+ > - βœ… Include a link to your social media post about your project
49
+ > - βœ… Submit by **November 30, 2025, 11:59 PM UTC**
50
+
51
+ **Join our [Discord Community](https://discord.gg/YgswRqxQ) β†’ Channel: `agents-mcp-hackathon-winter25πŸ†`** for latest information and active support during the hackathon.
52
+
53
+ ---
54
+
55
+ ## πŸš€ Quick Start (3 Easy Steps)
56
+
57
+ **1️⃣ Join & Register**
58
+ β†’ [Click "Request to join this org"](#) (top right) + [Complete registration form](https://huggingface.co/spaces/ysharma/gradio-hackathon-registration-winter25)
59
+
60
+ **2️⃣ Pick Your Track**
61
+ β†’ [Track 1: MCP Tools & Servers](#-track-1-mcp-tools--servers) or [Track 2: Agentic Applications](#-track-2-agentic-applications)
62
+
63
+ **3️⃣ Start Building (Nov 14)**
64
+ β†’ [See submission examples](#-submission-guidelines) | [Join HF Discord for help](https://discord.gg/Qe3jMKVczR) | [Access resources](#-resources--getting-started)
65
+
66
+ ---
67
+
68
+ <div align="center">
69
 
70
  ## 🌟 Welcome to Agents & MCP Hackathon: Winter 2025
71
 
72
+ </div>
73
+
74
+ Join us for the definitive AI agents and Model Context Protocol (MCP) development eventβ€”now bigger, better, and more accessible than ever. Build cutting-edge agentic applications powered by Gradio 6, leverage vibe coding to accelerate development, and compete for some of the most amazing πŸ€‘cash prizes and credits.
75
+
76
+ ### Why Participate?
77
+
78
+ <div align="center">
79
+
80
+ | πŸŽ“ **Learn & Master** | πŸ† **Win Big** | 🀝 **Network** | πŸš€ **Build & Ship** |
81
+ |----------|--------|------------|----------|
82
+ | Latest AI tech stack<br>MCP Protocol<br>Gradio 6 features | $15K+ in cash prizes<br>Free API credits<br>Sponsor rewards | 1000s of developers<br>Industry experts<br>Large AI community | Production-ready apps<br>Portfolio projects<br>Real-world impact |
83
+
84
+ </div>
85
+
86
+ ### What's New This Year
87
 
 
88
  - **Powered by Gradio 6** with enhanced mobile capabilities and visual editing
89
  - **3 full weekends** to build (Nov 14 - Nov 30)
90
+ - **Three new categories:** Productivity, Multimodal, and Games
91
+ - **Vibe coding friendly** β€” We welcome vibe-coding nd support the movement with our very own [gradio vibe editor](https://www.gradio.app/guides/developing-faster-with-reload-mode#vibe-mode)
92
  - **Social amplification** β€” share your work, gain visibility
93
+ - **FREE API Credits** coming soon from major AI Inference providers
94
 
95
+ ---
96
+
97
+ <div align="center">
 
 
98
 
99
  ## πŸ’° Why MCP Matters More Than Ever
100
 
101
+ </div>
 
 
 
102
 
103
+ Since our June'25 hackathon, MCP has gone from experimental to mainstream:
104
 
105
+ - ✨ **OpenAI officially adopted MCP**, later announced Apps SDK built on top of it ([DevDay 2025](https://openai.com/index/introducing-apps-in-chatgpt/))
106
+ - πŸͺŸ **Microsoft integrated MCP into Windows 11** ([Build 2025](https://blogs.windows.com/windowsexperience/2025/05/19/securing-the-model-context-protocol-building-a-safer-agentic-future-on-windows/))
107
+ - 🧠 **Google DeepMind joined the ecosystem** ([Demis Hassabis's tweet](https://x.com/demishassabis/status/1910107859041271977))
108
 
109
+ **MCP is no longer experimentalβ€”it's the foundation of modern agentic AI.** This is your opportunity to build on the protocol that's reshaping how AI systems connect to the world.
 
 
110
 
111
+ ---
112
 
113
+ <div align="center">
114
 
115
+ ## πŸ› οΈ Hackathon Tracks
 
 
 
 
116
 
117
+ </div>
118
 
119
+ <table>
120
+ <tr>
121
+ <td width="50%" valign="top">
122
 
123
  ### πŸ”§ Track 1: MCP Tools & Servers
 
124
 
125
+ Build MCP servers using Gradio 6 that extend LLM capabilities. [Any Gradio app can be an MCP server](https://huggingface.co/blog/gradio-mcp)β€”create tools for data analysis, API integrations, specialized workflows, or novel capabilities that make AI agents more powerful.
 
 
 
 
 
 
 
 
 
126
 
127
+ **What to Build:**
128
+ - MCP servers
129
+ - Tool integrations
130
+ - Protocol extensions
131
+ - Multi-tool systems
132
 
133
+ **Track Tag:** `"mcp-server-track"`
134
 
135
+ **Example Submissions:**
136
+ - [See example](https://huggingface.co/spaces/ysharma/sample1-hackathon-space-submission/blob/main/README.md)
137
 
138
+ **πŸ’° Prize Pool:**
139
  - πŸ₯‡ **First Place:** $1,500 USD
140
  - πŸ₯ˆ **Second Place:** $500 USD
141
 
142
+ </td>
143
+ <td width="50%" valign="top">
144
+
145
+ ### πŸ€– Track 2: Agentic Applications
146
+
147
+ Create complete AI agent applications that showcase autonomous reasoning, planning, and execution. Use MCP tools, vibe coding, or traditional developmentβ€”whatever brings your agent vision to life.
148
+
149
+ **Three Categories:**
150
+ 1. **Productivity/Workflow Automation** - Tag: `"agent-app-track-productivity"`
151
+ 2. **Multimodal Applications** - Tag: `"agent-app-track-multimodal"`
152
+ 3. **Gaming Applications** - Tag: `"agent-app-track-game"`
153
+
154
+ **Example Submissions:**
155
+ - [Productivity](https://huggingface.co/spaces/ysharma/sample2-hackathon-space-submission/blob/main/README.md) | [Multimodal](https://huggingface.co/spaces/ysharma/sample3-hackathon-space-submission/blob/main/README.md) | [Gaming](https://huggingface.co/spaces/ysharma/sample5-hackathon-space-submission/blob/main/README.md)
156
+
157
+ **πŸ’° Prize Pool (Per Category):**
158
  - πŸ₯‡ **First Place:** $2,500 USD
159
  - πŸ₯ˆ **Second Place:** $1,000 USD
160
  - πŸ₯‰ **Third Place:** $500 USD
161
 
162
+ </td>
163
+ </tr>
164
+ </table>
165
+
166
+ > [!TIP]
167
+ > **You can submit the same app to multiple tracks!** ([See example](https://huggingface.co/spaces/ysharma/sample4-hackathon-space-submission/blob/main/README.md))
168
+ > **You can submit multiple entries!** Build as many projects as you want.
169
+
170
+ ---
171
+
172
+ <div align="center">
173
+
174
+ ## 🎁 Prize Structure
175
+
176
+ **Total Prize Pool: $15,000+ USD + API Credits + Sponsor Bonuses**
177
+
178
+ </div>
179
+
180
+ ### πŸ† Main Track Prizes
181
+
182
+ **MCP Track:**
183
+ - πŸ₯‡ First Place: **$1,500 USD**
184
+ - πŸ₯ˆ Second Place: **$500 USD**
185
+
186
+ **Agent Track** (3 prizes per category Γ— 3 categories):
187
+ - πŸ₯‡ First Place: **$2,500 USD** (Γ—3 categories)
188
+ - πŸ₯ˆ Second Place: **$1,000 USD** (Γ—3 categories)
189
+ - πŸ₯‰ Third Place: **$500 USD** (Γ—3 categories)
190
+
191
+ ### ⭐ Special Awards
192
+
193
  - 🌟 **Community Choice Award:** $1,000 USD (most social engagement)
194
+ - 🏒 **Sponsor Choice Awards:** TBA (announced with sponsors)
195
+ - πŸ€— **Hugging Face Merch:** For most engaging participants and community builders
196
 
197
+ ---
198
 
199
+ <div align="center">
200
 
201
+ ## πŸ’Έ Sponsors & Credits
 
202
 
203
+ </div>
 
 
 
 
204
 
205
+ **API & Compute Credits** (Details announced soon):
206
+ - We are securing API credits for participants from major AI providers
207
+ - Access to latest and strongest LLMs from major providers
208
 
209
+ Announcements rolling out weekly. Follow [@Gradio](https://x.com/Gradio) for the latest updates.
210
 
211
+ ---
 
 
 
 
 
 
212
 
213
+ <div align="center">
214
+
215
+ ## πŸ—“οΈ Timeline
216
+
217
+ </div>
218
+
219
+ ### πŸ“… Pre-Hackathon Phase
220
+ **October 13 - November 13**
221
+ - Sponsor announcements rolling out
222
+ - Educational content releases
223
+ - Registration opens
224
+ - Community building
225
+
226
+ ### πŸ”¨ Hackathon Period
227
+ - **November 14 (Friday, 12:00 AM UTC)** - πŸš€ Hackathon opens!
228
+ - **November 14/15** - πŸ“Ί Kickoff stream on YouTube (time TBA)
229
+ - **November 17-28** - πŸ’¬ Office hours with Gradio team and sponsors
230
+ - **November 30 (Saturday, 11:59 PM UTC)** - ⏰ Final submissions due
231
 
232
+ ### πŸ… Post-Hackathon Phase
233
+ - **December 1-14** - πŸ‘¨β€βš–οΈ Judging period
234
+ - **December 15** - πŸŽ‰ Winners announcement and showcase
235
 
236
+ ---
237
+
238
+ <div align="center">
239
+
240
+ ## πŸ“ Submission Guidelines
241
+
242
+ </div>
 
 
 
243
 
244
+ ### All Tracks - General Requirements
245
+
246
+ 1. **Publish your project** as a Hugging Face Space in this organization
247
+ 2. **Add the appropriate track tag** to your Space `README.md`:
248
+ - `"mcp-server-track"` for Track 1
249
+ - `"agent-app-track-productivity"`, `"agent-app-track-multimodal"`, or `"agent-app-track-game"` for Track 2
250
+ 3. **Include a link to your social media post** (X, LinkedIn, etc.) about your project
251
+ 4. **Include a demo video** (1-5 minutes) showing your project in action. For example, look at some of the submissions from the Hackathon in June:
252
+ - [Example 1](https://huggingface.co/spaces/Agents-MCP-Hackathon/Sentinel_One/blob/main/README.md#welcome-to-our-submission-for-the-hugging-face-genai-agents--mcp-hackathonthis-project-showcases-a-multi-agent-system-powered-by-gradio-and-smolagents-designed-to-monitor-process-and-analyze-environmental-data-to-assess-climate-related-risks-and-provide-recommendations-link-to-demo--httpsyoutubealk_husrl4w)
253
+ - [Example 2](https://huggingface.co/spaces/Agents-MCP-Hackathon/cs-agent/blob/main/README.md#%F0%9F%93%B9-preview)
254
+ - [Example 3](https://huggingface.co/spaces/Agents-MCP-Hackathon/geocalc-mcp/blob/main/README.md#%F0%9F%8E%A5-demo-video)
255
+ 5. **Original work only** - All work must be created during the hackathon period (Nov 14-30)
256
+
257
+ ### Track-Specific Requirements
258
+
259
+ **πŸ”§ Track 1: MCP Tools & Servers**
260
  - Must be a functioning MCP server built with Gradio
261
  - Include video showing integration with an MCP client (Claude Desktop, Cursor, etc.)
262
  - Document the tool's purpose, capabilities, and usage
263
 
264
+ **πŸ€– Track 2: Agentic Applications**
265
  - Must demonstrate autonomous agent behavior (planning, reasoning, execution)
266
  - Can use MCP tools, custom tools, or external APIs
267
+ - **Bonus points** for showcasing Context Engineering using Gradio
268
+ - Learn more: [Anthropic](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents) | [LangChain](https://blog.langchain.com/context-engineering-for-agents/) | [dbreunig](https://www.dbreunig.com/2025/07/24/why-the-term-context-engineering-matters.html)
269
  - Show clear user value and practical application
270
 
271
+ ---
272
 
273
+ <div align="center">
274
 
275
+ ## πŸ… Judging Criteria
276
+
277
+ </div>
278
+
279
+ Projects will be evaluated on:
280
+ - **Submissions should be complete** - HF Space + Social media post + Documentation in the Space readme + Demo Video recording of your Space
281
+ - **Design/Polished UI-UX** - How polished, intuitive, and easy-to-use the app is?
282
+ - **Functionality** - To what extent did the app uses the relevant Gradio functionalities (Gradio 6, MCPs, Agentic Chatbots etc)?
283
+ - **Creativity** - How innovative or original is the project idea and implementation?
284
+ - **Documentation** - How well communicated is the implementation in the README and/or demo video?
285
+ - **Real-world impact** - How much potential does the project have for real-world usefulness or application?
286
 
287
  **Community Choice Award** based on:
288
  - Social media engagement (likes, shares, comments)
289
+ - Space interactions (_Discussions_ tab) on Hugging Face
290
+ - Discord community engagement
291
 
292
+ ---
293
 
294
+ ## πŸ’» Resources & Getting Started
 
 
 
295
 
296
+ <details>
297
+ <summary><b>πŸ“š Click to see Technical Documentation</b></summary>
298
 
299
+ ### Official Documentation
300
+ - [Getting Started with MCP in Gradio](https://huggingface.co/blog/gradio-mcp)
301
+ - [Gradio 6 Documentation](https://www.gradio.app/)
302
+ - [Building Mobile-First AI Apps](https://github.com/gradio-app/gradio-mobile-app)
303
+ - [Custom Components Guide](https://www.gradio.app/guides/custom-components-in-five-minutes)
304
+ - [Vibe Coding with Gradio](https://www.youtube.com/watch?v=dis1BwDzmYs)
305
+ - [Agent Development Patterns](https://www.gradio.app/guides/agents-and-tool-usage)
306
+
307
+ ### Educational Content
308
+ - **Video Tutorials:** Coming soon
309
+ - **Blog Posts / Guides:** Case Studies from June Hackathon
310
+ - **Office Hours:** Live sessions with experts (schedule announced soon)
311
+
312
+ </details>
313
+
314
+ ---
315
+
316
+ ## ❓ Frequently Asked Questions
317
+
318
+ <details>
319
+ <summary><b>❓ I'm new to MCP. Can I still participate?</b></summary>
320
+
321
+ Absolutely! We provide comprehensive tutorials on MCP and will have office hours throughout to support participants. Track 2 doesn't necessarily require MCP knowledge.
322
+ </details>
323
+
324
+ <details>
325
+ <summary><b>πŸ› οΈ Can I use vibe coding tools like Bolt, Lovable, or Cursor?</b></summary>
326
+
327
+ Yes! Use any tools that help you build. We celebrate results, not just process.
328
+ </details>
329
+
330
+ <details>
331
+ <summary><b>πŸ”¨ Do I need to build everything from scratch?</b></summary>
332
+
333
+ No. You can use existing libraries, frameworks, and tools. Just ensure your core contribution is original and created during the hackathon.
334
+ </details>
335
+
336
+ <details>
337
+ <summary><b>πŸ‘₯ Can I participate solo or do I need a team?</b></summary>
338
 
339
+ Both! Participate individually or in teams of 2-5 members.
340
+ </details>
 
 
 
 
341
 
342
+ <details>
343
+ <summary><b>πŸ”„ What if I participated in the June hackathon?</b></summary>
344
 
345
+ Welcome back! Build something new or significantly evolve your previous project. Previous winners are eligible.
346
+ </details>
347
 
348
+ <details>
349
+ <summary><b>πŸ’» Is there a specific programming language requirement?</b></summary>
350
 
351
+ Gradio is Python-based, but you can integrate other languages/services as needed.
352
+ </details>
353
 
354
+ <details>
355
+ <summary><b>❓ How do I get help during the hackathon?</b></summary>
356
 
357
+ Discord support, office hours, documentation, and community help available throughout.
358
+ </details>
359
 
360
+ <details>
361
+ <summary><b>🎯 Can I submit to multiple tracks?</b></summary>
362
 
363
+ Yes! Submit the same project to multiple tracks or create multiple separate projects.
364
+ </details>
365
 
366
+ <details>
367
+ <summary><b>πŸ“± What counts as "mobile-first"?</b></summary>
368
 
369
+ Responsive design, touch optimization, mobile-appropriate interactions. Doesn't need to be a native appβ€”PWAs and responsive web apps qualify.
370
+ </details>
371
 
372
  ---
373
 
374
+ ## πŸ‘₯ Connect & Community
375
+
376
+ - **πŸ’¬ Discord:** [Join #agents-mcp-hackathon-winter25πŸ†](https://discord.gg/YgswRqxQ)
377
+ - **🐦 Twitter/X:** [@Gradio](https://x.com/gradio)
378
+ - **πŸ’Ό LinkedIn:** [Gradio](https://www.linkedin.com/company/gradio/)
379
+
380
+ ---
381
+
382
+ ## βš–οΈ Policies & Rules
383
+
384
+ <details>
385
+ <summary><b>πŸ“‹ Click to see Policies & Guidelines</b></summary>
386
+
387
+ By participating, you agree to:
388
+ - [Code of Conduct](https://huggingface.co/code-of-conduct)
389
+ - [Submission Guidelines](#submission-guidelines)
390
+ - [Intellectual Property Policy](https://huggingface.co/content-policy)
391
+
392
+ ### Important Rules:
393
+ - βœ… All submissions must be original work
394
+ - βœ… Projects must be created between November 14-30, 2025
395
+ - βœ… Open source licenses encouraged (MIT, Apache 2.0, etc.)
396
+ - βœ… Participants retain IP rights to their work
397
+ - βœ… By submitting, you grant Hugging Face/Gradio right to showcase your work
398
+
399
+ </details>
400
+
401
+ ---
402
+
403
+ <div align="center">
404
+
405
  ## πŸš€ From June to November: The Evolution
406
 
407
+ **June 2025:** 4,200+ registrations | ~650 submissions | $1M+ in API/GPU Credits
408
+
409
+ **November 2025:** Targeting trippling the registrations | 3x the prizes | Establishing Gradio agents-mcp hackathon as the industry-standard definitive event
410
 
411
  Join the community that launched the MCP developer movement. Build the future of agentic AI.
412
 
413
+ ---
414
+
415
+ **πŸ“… Registration open**
416
+ **πŸ”¨ Building starts: November 14, 2025**
417
+ **⏰ Submissions close: November 30, 2025**
418
 
419
  ---
420
 
421
+ <div style="margin: 40px 0;">
422
+ <a href="https://huggingface.co/spaces/ysharma/gradio-hackathon-registration-winter25"
423
+ target="_blank"
424
+ style="display: inline-block;
425
+ background: linear-gradient(135deg, #0a0a0a 0%, #FF7A00 35%, #4A90E2 70%, #ffffff 100%);
426
+ color: black;
427
+ padding: 20px 40px;
428
+ text-decoration: none;
429
+ border-radius: 12px;
430
+ font-weight: bold;
431
+ font-size: 24px;
432
+ box-shadow: 0 4px 12px rgba(0,0,0,0.15);
433
+ transition: transform 0.2s;">
434
+ 🎯 REGISTER NOW & START BUILDING
435
+ </a>
436
+ </div>
437
+
438
  *Questions? Reach out in [Discord](https://discord.gg/Qe3jMKVczR) or email: gradio-team@huggingface.co*
439
+
440
+ </div>