Update README.md
Browse files
README.md
CHANGED
@@ -1,10 +1,252 @@
|
|
1 |
---
|
2 |
title: README
|
3 |
-
emoji:
|
4 |
-
colorFrom:
|
5 |
colorTo: red
|
6 |
sdk: static
|
7 |
-
pinned:
|
8 |
---
|
9 |
|
10 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
---
|
2 |
title: README
|
3 |
+
emoji: 🏆
|
4 |
+
colorFrom: yellow
|
5 |
colorTo: red
|
6 |
sdk: static
|
7 |
+
pinned: true
|
8 |
---
|
9 |
|
10 |
+
|
11 |
+
# 🤖 Agents & MCP Hackathon: November 2025 🚀 (Tentative/Placeholder name)
|
12 |
+
|
13 |
+

|
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-nov-2025"
|
23 |
+
target="_blank"
|
24 |
+
style="display: inline-block;
|
25 |
+
background: #FF8C1A;
|
26 |
+
color: white;
|
27 |
+
padding: 20px 40px;
|
28 |
+
text-decoration: none;
|
29 |
+
border-radius: 12px;
|
30 |
+
font-weight: bold;
|
31 |
+
font-size: 24px;
|
32 |
+
box-shadow: 0 4px 12px rgba(0,0,0,0.15);
|
33 |
+
transition: transform 0.2s;">
|
34 |
+
🚀 Register for the Hackathon
|
35 |
+
</a>
|
36 |
+
</div>
|
37 |
+
|
38 |
+
|
39 |
+
## 🌟 Welcome to Agents & MCP Hackathon: November 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 |
+
|
93 |
+
**What to Build:** Full-stack agent apps, multi-agent systems, autonomous workflows, AI assistants
|
94 |
+
|
95 |
+
### 📱 Track 3: AI-First Mobile Experiences
|
96 |
+
Leverage Gradio 6's mobile capabilities to create AI applications designed for mobile-first interaction. Build responsive, touch-optimized experiences that demo the best use of AI on smartphones and tablets.
|
97 |
+
|
98 |
+
**What to Build:** Mobile-optimized AI apps, touch interfaces, on-device experiences, progressive web apps
|
99 |
+
|
100 |
+
## 🎁 Prize Structure (tentative)
|
101 |
+
|
102 |
+
**Total Prize Pool: $50,000+ USD**
|
103 |
+
|
104 |
+
### Main Track Prizes (Per Track):
|
105 |
+
- 🥇 **First Place:** $5,000 USD
|
106 |
+
- 🥈 **Second Place:** $2,000 USD
|
107 |
+
- 🥉 **Third Place:** $1,000 USD
|
108 |
+
|
109 |
+
### Special Awards:
|
110 |
+
- 👑 **Title Sponsor Grand Prize:** $10,000 USD (Best Overall)
|
111 |
+
- 🎨 **Most Innovative Mobile UX:** $2,000 USD
|
112 |
+
- 💫 **Best Vibe-Coded Project:** $1,500 USD
|
113 |
+
- 🎬 **AI Video Generation Excellence:** $1,000 USD
|
114 |
+
- 🌟 **Community Choice Award:** $1,500 USD (most social engagement)
|
115 |
+
- 💎 **Most Innovative Use of MCP:** $1,500 USD
|
116 |
+
- 🏢 **Sponsor Choice Awards:** Multiple $500-$2,000 prizes (announced with sponsors)
|
117 |
+
- 🤗 **Hugging Face Merch:** Top 50 most engaging participants
|
118 |
+
|
119 |
+
## 🗓️ Schedule
|
120 |
+
|
121 |
+
### Pre-Hackathon
|
122 |
+
- **October 10 - 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:** Live kickoff event on YouTube (time TBA)
|
127 |
+
- **November 18-22:** Office hours with Gradio team and sponsors
|
128 |
+
- **Mid-Hackathon:** Check-in workshops and Q&A sessions
|
129 |
+
- **November 30 (Saturday, 11:59 PM UTC):** Final submissions due
|
130 |
+
|
131 |
+
### Post-Hackathon
|
132 |
+
- **December 1-14:** Judging period
|
133 |
+
- **December 15:** Winners announcement and showcase
|
134 |
+
|
135 |
+
## 💻 Resources & Getting Started
|
136 |
+
|
137 |
+
### Technical Documentation
|
138 |
+
- [Getting Started with MCP in Gradio](https://huggingface.co/blog/gradio-mcp)
|
139 |
+
- [Gradio 6 Documentation](https://www.gradio.app/) (placeholder)
|
140 |
+
- [Building Mobile-First AI Apps](https://www.gradio.app/guides/mobile-friendly-apps) (placeholder)
|
141 |
+
- [Custom Components Guide](https://www.gradio.app/guides/custom-components-in-five-minutes)
|
142 |
+
- [Vibe Coding with Gradio](https://www.gradio.app/guides/vibe-coding) (placeholder)
|
143 |
+
- [Agent Development Patterns](https://www.gradio.app/guides/agents-and-tool-usage)
|
144 |
+
|
145 |
+
### Educational Content (tentative)
|
146 |
+
- **Video Tutorials:** ...
|
147 |
+
- **Blog Posts / Guides:** Case Studies from June Hackathon
|
148 |
+
- **Office Hours:** Live sessions with experts (schedule announced Nov 10)
|
149 |
+
|
150 |
+
## 🎯 Submission Guidelines
|
151 |
+
|
152 |
+
### All Tracks - General Requirements:
|
153 |
+
1. Publish your project as a Hugging Face Space
|
154 |
+
2. Add the appropriate track tag to your Space `README.md`:
|
155 |
+
- `"mcp-server-track"` for Track 1
|
156 |
+
- `"agent-app-track"` for Track 2
|
157 |
+
- `"mobile-ai-track"` for Track 3
|
158 |
+
3. **Include a link to your social media post** (X, LinkedIn, etc.) about your project
|
159 |
+
4. Include a demo video (2-5 minutes) showing your project in action
|
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 |
+
- Show clear user value and practical application
|
171 |
+
|
172 |
+
### Track 3: AI-First Mobile Experiences
|
173 |
+
- Must be optimized for mobile devices (responsive, touch-friendly)
|
174 |
+
- Test on actual mobile devices or emulators
|
175 |
+
- Include screenshots/video of mobile experience
|
176 |
+
|
177 |
+
## 🏅 Judging Criteria (tentaive)
|
178 |
+
|
179 |
+
Projects evaluated on:
|
180 |
+
...
|
181 |
+
|
182 |
+
|
183 |
+
**Community Choice Award** based on:
|
184 |
+
- Social media engagement (likes, shares, comments)
|
185 |
+
- Space interactions on Hugging Face
|
186 |
+
- Discord community engagement
|
187 |
+
|
188 |
+
## 👥 Connect & Community
|
189 |
+
|
190 |
+
- **Discord:** [Join #agents-mcp-hackathon-nov25](https://discord.gg/Qe3jMKVczR)
|
191 |
+
- **Twitter/X:** [@Gradio](https://x.com/gradio)
|
192 |
+
- **LinkedIn:** [Gradio]()
|
193 |
+
- **YouTube:** [Subscribe for tutorials]()
|
194 |
+
|
195 |
+
## ⚖️ Policies & Rules
|
196 |
+
|
197 |
+
By participating, you agree to:
|
198 |
+
- [Code of Conduct](https://huggingface.co/code-of-conduct)
|
199 |
+
- [Submission Guidelines](#submission-guidelines)
|
200 |
+
- [Intellectual Property Policy](https://huggingface.co/content-policy)
|
201 |
+
|
202 |
+
**Important:**
|
203 |
+
- All submissions must be original work
|
204 |
+
- Projects must be created between November 14-30, 2025
|
205 |
+
- Open source licenses encouraged (MIT, Apache 2.0, etc.)
|
206 |
+
- Participants retain IP rights to their work
|
207 |
+
- By submitting, you grant Hugging Face/Gradio right to showcase your work
|
208 |
+
|
209 |
+
## ❓ FAQ
|
210 |
+
|
211 |
+
**Q: I'm new to MCP. Can I still participate?**
|
212 |
+
A: Absolutely! We're releasing comprehensive tutorials and will have office hours throughout. Track 2 and 3 don't require MCP knowledge.
|
213 |
+
|
214 |
+
**Q: Can I use vibe coding tools like Bolt, Lovable, or Cursor?**
|
215 |
+
A: Yes! Use any tools that help you build. We celebrate results, not just process.
|
216 |
+
|
217 |
+
**Q: Do I need to build everything from scratch?**
|
218 |
+
A: No. You can use existing libraries, frameworks, and tools. Just ensure your core contribution is original and created during the hackathon.
|
219 |
+
|
220 |
+
**Q: Can I participate solo or do I need a team?**
|
221 |
+
A: Both! Participate individually or in teams of 2-5 members.
|
222 |
+
|
223 |
+
**Q: What if I participated in the June hackathon?**
|
224 |
+
A: Welcome back! Build something new or significantly evolve your previous project. Previous winners are eligible.
|
225 |
+
|
226 |
+
**Q: Is there a specific programming language requirement?**
|
227 |
+
A: Gradio is Python-based, but you can integrate other languages/services as needed.
|
228 |
+
|
229 |
+
**Q: How do I get help during the hackathon?**
|
230 |
+
A: Discord support, office hours, documentation, and community help available throughout.
|
231 |
+
|
232 |
+
**Q: Can I submit to multiple tracks?**
|
233 |
+
A: Yes, go for it!
|
234 |
+
|
235 |
+
**Q: What counts as "mobile-first" for Track 3?**
|
236 |
+
A: Responsive design, touch optimization, mobile-appropriate interactions. Doesn't need to be a native app—PWAs and responsive web apps qualify.
|
237 |
+
|
238 |
+
---
|
239 |
+
|
240 |
+
## 🚀 From June to November: The Evolution
|
241 |
+
|
242 |
+
**June 2025:** 4,200 registrations, 630 submissions, $1M+ in credits
|
243 |
+
**November 2025:** Targeting 12,000 registrations, 3x the prizes, establishing the Gradio agents hackathon as a industry standard definitive event
|
244 |
+
|
245 |
+
Join the community that launched the MCP developer movement. Build the future of agentic AI.
|
246 |
+
|
247 |
+
**Registration opens: November 1, 2025**
|
248 |
+
**Building starts: November 14, 2025**
|
249 |
+
|
250 |
+
---
|
251 |
+
|
252 |
+
*Questions? Reach out in [Discord](https://discord.gg/Qe3jMKVczR) or email: gradio-team@huggingface.co*
|