---
title: README
emoji: π¨
colorFrom: indigo
colorTo: pink
sdk: static
pinned: false
---
# Welcome to the Gradio Themes Party π
## Join the organization by clicking the 'Join this org' button on the top-right corner
### Live Themes Gallery will show Gradio Themes that are created by participants and they will be sorted by likes.
- We would like to extend an invitation to the **Gradio Themes Party**, a community event aimed at designing visually stunning and personalized themes for Gradio apps. The event will take place over a two-week period, **starting from Monday, March 20th** and **ending on Sunday, April 2nd**. We are thrilled to invite and witness what the community builds with Gradio Themes, as they develop attractive themes to enhance the user experience of Gradio applications.
- We will be organizing this event here on Hugging Face Hub and would be engaging through Huggingface Discord Server. Check the dedicated Gradio channel to stay updated with the event (need to set up a channel(or not?)). Prizes will be given at the end of the event. See the Prizes section
- Gradio is a widely used platform for creating demos of machine learning models, enabling the creation of web-based user interfaces solely using Python. As the interface of a Gradio application has a direct impact on the user experience, we recognize the importance of creating an aesthetically pleasing interface to enhance the app's value. As such, we have introduced **Gradio Themes**, a new feature that enables users to add themes and customize and beautify their applications. Additionally, we are hosting the **Gradio Themes Party** to encourage developers to design stunning and impressive themes for their Gradio apps and front-ends.
- Gradio can be installed via pip and comes preinstalled in Hugging Face Spaces, the latest version of Gradio that supports Themes is 3.22, and it can be set in the README in Spaces by setting the sdk_version, for example sdk_version: 3.22.0
. To learn more about Gradio, see the Getting Started Guide: https://gradio.app/getting_started/
- By using Gradio Themes, you can enhance the user experience of your app. You can achieve this by adding default themes such as Base, Soft, Glass, Monochrome, among others. Additionally, you can also extend and personalize existing themes, or create your own themes from scratch. There are a multitude of options available to customize the user interface of your app to suit your needs. To learn more about Gradio Themes, see the Themes Guide at: https://gradio.app/themes_guide/
## Hackathon Tracks :
Participants can take part in different tracks of the Themes Hackathon. Each track will have winners announced at the end of the event! These events are:-
1. The **Theme Creation Contest** - Participants would compete to create the most creative or visually stunning theme for a Gradio app. We would add the best/most creative theme to our set of default themes as a prize, plus the top three winners will get some goodies.
2. **Building Sector-specific themes** - Participants would create Gradio themes targeting specific sectors like finance/health/education/art. Here participants can also choose to create themes specific to different companies - for example, an openai green theme / huggingface emoji theme / meta blue theme, etc.
3. **Inclusivity and Accessibility** focused themes - Participants can submit apps built around themes that prioritize inclusivity and accessibility. This segment places a strong emphasis on accessibility, for example, building an app with themes that are tailored to those who are colorblind or creating apps that support causes related to diversity and inclusion.
4. **Best Dark Toggle** - In this segment, participants will be tasked with designing a theme that provides the most optimal effects when using a dark mode toggle.
5. **Gradio in disguiseπ₯Έ** themes - Under this extremely interesting track, we encourage participants to design themes that give Gradio a completely different look and feel from its default theme. This involves creating unique combinations of colors, button designs, fonts, backgrounds, and other design elements to disguise Gradio's appearance and create a fresh and distinct user experience.
6. **Gradio App redesign challenge** - Participants will be challenged to redesign an existing trending Gradio app using new and creative themes. Participants will have to pick up an existing Gradio application and improve its user experience using Themes. Apps that would be rendered more visually appealing and user-friendly would be considered for this prize.
7. **Build new Gradio Apps that utilize Themes** - Under this category, we invite participants to create impressive demos that utilize themes. Whether it's using default themes, extending them, or creating new ones from scratch, we encourage participants to incorporate themes into their Gradio demos to make them more visually appealing and engaging.
## How to Participate :
To participate in any track in the Themes Hackathon -
- For tracks 1 to 5, you have to submit a new Theme:
- Step 1: Join the Gradio-Theme Party organization on Hub.
- Step 2: Read up about Gradio's new theming capabilities here - [Theming Guide](https://gradio.app/theming-guide/ )
- Step 3: Create a brand new theme - Either by extending the default or other user-generated themes or creating a new theme from scratch (WIP for code sample)
- Step 4: Upload the theme to the Theme Gallery in the Hub, e.g. `my_theme.push_to_hub(repo_name="my_theme")`. For more information on uploading themes, see the [Sharing Themes](https://gradio.app/theming-guide/#sharing-themes) section of the guide.
- Step 5: Share your themes with the community on social media and spread the good word about the Hackathon π€
- For Track 6, the Gradio app redesign challenge, you have to submit a Gradio demo:
- Step 1: Join the Gradio-Theme Party organization on Hub.
- Step 2: Read up about Gradio's new theming capabilities here - [Theming Guide](https://gradio.app/theming-guide/ )
- Step 3: Duplicate any existing Gradio demo (kudos if it is trending π)
- Step 4: Add your theme effects to the demo; for example, add color, background, etc.
- Step 5: Publish the demo back on the Hub. Note that the redesigned app must be submitted to the themes-party organization so that team can find it and others can see it. This will ensure the highest visibility for your effort.
- For Track 7, the Gradio app-building challenge, you have to submit a Gradio demo as well:
- Step 1: Join the Gradio-Theme Party organization on Hub.
- Step 2: Read up about Gradio's new theming capabilities here - [Theming Guide](https://gradio.app/theming-guide/ )
- Step 3: Build a new Gradio demo (extra kudos if it is from making demos Discord channel π·π»ββοΈπ·π»)
- Step 4: Make sure to utilize Gradio Themes in the demo; for example, add color, background, etc.
- Step 5: Publish the demo on the Hub to the themes-party organization so that the team can find it and others can see it. This will ensure the highest visibility for your effort.
## Prizes
Are you ready to win big? We're bringing the excitement to this Hackathon with some incredible prizes up for grabs! You're free to submit as many entries as you want, so get ready to have a great time unleashing your creativity.
- For the themes submitted for categories 1 to 5 - The top 3 winners in each track will be decided based on the number of likes and the winners each will each get
- π€© We'll add the most liked theme to our set of default ones as a top prize
- Hugging Face PRO subscription for x time (need to conform this)
- Huggingface goodies for the top three winners from our merch store
- For categories 6 and 7 - The top 3 Gradio Apps in each track will be decided by Huggingface and Gradio team based on aesthetics. Winners will each get -
- Swag from Hugging Face merch shop: t-shirt, hoodie, or mug of your choice
- Hugging Face PRO subscription for one month
- π Themes event badge on HF for all participants!