Spaces:
Running
Running
| title: README | |
| emoji: 🏆 | |
| colorFrom: red | |
| colorTo: yellow | |
| sdk: static | |
| pinned: false | |
| **Placeholder Text with Dummy links -- Some items are not yet finalised. Thanks for your patience and support on this.** | |
| --- | |
| # 🤖 Gradio Agents & MCP Hackathon 2025 🚀 | |
|  | |
| **Ready to participate?** | |
| <a href="https://huggingface.co/spaces/ysharma/gradio-hackathon-registration-2025" | |
| style="background: #f7cc02; color: white; padding: 12px 24px; text-decoration: none; | |
| border-radius: 8px; font-weight: bold; margin-left: 10px;"> | |
| 🚀 Join the Hackathon | |
| </a> | |
| ## 🌟 Welcome to the Future of AI Agents! | |
| Join us for an exciting week-long adventure into the world of Model Context Protocol (MCP) and AI Agents! This hackathon brings together developers, AI enthusiasts, and innovators to push the boundaries of what's possible with Anthropic's MCP and agentic systems. | |
| **📅 Date:** June 2 - June 8, 2025 | |
| **📍 Location:** Global & Online | |
| **🏆 Prizes:** $10,000 cash-prizes and more to be won! | |
| **🎁 Bonus:** Free API credits for participants* from our sponsor [Sambanova.AI](https://sambanova.ai/) | |
| ## 💡 What is MCP? | |
| Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to LLMs. MCP enables models to interact with the world. Learn more at [modelcontextprotocol.io](https://modelcontextprotocol.io/introduction). | |
| ## 🛠️ Hackathon Tracks | |
| ### 🔧 Track 1: MCP Server Implementation | |
| Build, extend, or innovate on MCP servers with Gradio. Create powerful tools that leverage the full potential of the Model Context Protocol. | |
| ### 🧩 Track 2: Custom Agent Components | |
| Design and develop custom Gradio components specifically optimized for agent interactions. Make agent interfaces more intuitive, responsive, and powerful. | |
| ### 🤖 Track 3: Agentic Demo Showcase | |
| Create a complete end-to-end gradio application that demonstrates the power of AI agents (using MCP or not). Show us what agents can do! | |
| ## 🎁 Prizes | |
| Total prize pool: **$10,000 USD in cash plus more goodies** | |
| ### For each track: | |
| - 🥇 First Place: $2,500 USD | |
| - 🥈 Second Place: $500 USD | |
| ### Special awards: | |
| - 🌟 Community Choice: $500 USD | |
| - 💫 Most Innovative Use of MCP: $500 USD | |
| - 🤗 HF Merch to the most engaging participants | |
| All participants will receive: | |
| - 🎖️ Digital participation certificate | |
| - 👕 Exclusive digital hackathon badge for your Hugging Face profile | |
| ## 📝 How to Participate | |
| 1. **Join our Organization**: Click the "Request to join this org" button at the top right corner of this page | |
| 2. **Register**: Fill out [this registration form](https://forms.gle/exampleRegistrationLink) | |
| 3. **Form a Team**: Teams of 1-5 members allowed | |
| 4. **Build Your Project**: Follow the specific guidelines for your chosen track | |
| 5. **Submit**: Push your project to this organization before the deadline (June 1, 2025, 11:59 PM UTC) | |
| ## 🗓️ Schedule | |
| ### Pre-Hackathon Events | |
| - May 20-26: Hackathon announcements | |
| - May 21-22: Gradio Agent Course release | |
| ### Hackathon Week | |
| - June-2: Live-kickoff YouTube event to set the tone and welcome the participants (9:00 AM UTC) | |
| - Gradio Office Hours: | |
| - MCP Support with [Abubakar](https://huggingface.co/abidlabs): June-3 10:00 AM UTC (Time TBD) | |
| - Custom Components with [Freddy](https://huggingface.co/freddyaboulton) and [Pete](https://huggingface.co/pngwn): June-4 10:00 PM UTC (Time TBD) | |
| - Agent Development with [Yuvi](https://huggingface.co/ysharma): June-5 10:00 PM UTC (Time TBD) | |
| - June 8: Final Submissions Due (11:59 PM UTC) | |
| ### Post-Hackathon | |
| - June 9-12: Judging Period | |
| - June 13: Winners Announcement | |
| ## 💻 Resources | |
| ### Technical Documentation | |
| - [Getting Started with MCP with Gradio](https://huggingface.co/blog/gradio-mcp) | |
| - [Gradio Component Development Guide](https://www.gradio.app/guides/custom-components-in-five-minutes) | |
| - [Agent Development Resources](https://www.gradio.app/guides/agents-and-tool-usage) | |
| ### Starter Templates | |
| - [MCP Server Boilerplate](https://dummy-link-for-mcp-server-starter) | |
| - [Custom Component Template](https://dummy-link-for-gradio-component-template) | |
| - [Basic Agent Demo](https://dummy-link-for-basic-agent-demo) | |
| ## 🎯 Submission Guidelines | |
| ### Track 1: MCP Server Implementation | |
| 1. Your submission must implement MCP Server (and or Client) functionalities | |
| 2. Create a Gradio Space showing the MCP Server in action | |
| 3. If your implementations involve IDEs (or Claude Desktop) include a video recording. If you are using another Gradio ap as Host, that is also an acceptable entry. | |
| 4. Include your Gradio Space repo README.md with: | |
| - Overview of your implementation | |
| - Setup instructions | |
| - Examples of usage | |
| 5. Tag your Spaces readme with "mcp-server-track" | |
| ### Track 2: Custom Agent Components | |
| 1. Custom Component must be compatible with Gradio's latest version | |
| 2. Include a Gradio demo on Spaces showing the component in action | |
| 3. Provide documentation on component usage through Spaces | |
| 4. Tag your demo readme with "custom-component-track" | |
| ### Track 3: Agentic Demo | |
| 1. Create a complete Gradio app that showcases AI agents | |
| 2. Host the app on Spaces | |
| 3. Tag your Spaces readme with "agent-demo-track" | |
| ## 👥 Connect With Us | |
| - Join our [Discord Community](https://discord.gg/m8BNVTHW) | |
| - Follow us on [Twitter](https://x.com/Gradio), [LinkedIn](https://www.linkedin.com/company/gradio/) | |
| - Subscribe to our [YouTube Channel](https://www.youtube.com/@OfficialGradio) | |
| ## ⚖️ Hackathon Policies | |
| By participating in this hackathon, you agree to: | |
| - Our [Code of Conduct](https://huggingface.co/code-of-conduct) | |
| - The [Submission Guidelines](https://huggingface.co/Agents-MCP-Hackathon#:~:text=%F0%9F%8E%AF%20Submission%20Guidelines) | |
| - Our [Intellectual Property Policy](https://huggingface.co/content-policy#:~:text=4.%20Privacy%20and%20Intellectual%20Property%20(IP)) | |
| All submissions must be original work created during the hackathon period. | |
| ## ❓ FAQ | |
| **Q: Do I need to have experience with MCP to participate?** | |
| A: No! We welcome participants of all skill levels. We'll provide resources to help you get started. | |
| **Q: Can I participate as an individual?** | |
| A: Yes! You can participate as an individual or in a team of up to 5 members. | |
| **Q: How will projects be judged?** | |
| A: Projects will be evaluated based on innovation, technical implementation, usability, and impact. Community like on Spaces will also be considered. | |
| **Q: Will there be support available during the hackathon?** | |
| A: Yes! We'll have regular office hours with experts, a dedicated Discord channel, and comprehensive documentation. | |
| --- | |
| *We can't wait to see what you build! Join us for this exciting journey into the future of AI agents.* | |