Git Bounty 💰

Git Bounty generates personalized anime-style pirate bounty posters based on a user's GitHub activity. Simply input a GitHub username, and the app pulls relevant data like contributions, favorite programming languages, and more to create a unique bounty poster.

🖥️ Features

• Profile Integration: Fetches GitHub profile details such as username, followers, location, and contributions.
• Anime-Style Poster: Generates a bounty poster with a tech-pirate theme based on GitHub activity.
• Programming Flair: Highlights the user's most used programming languages.
• Custom Bounty: Sets the bounty amount to match total contributions.
• Downloadable Poster: Save and share your personalized bounty poster.

🚀 Live Demo

Check out the live app Git Bounty : https://gitbounty.streamlit.app/

🛠️ How It Works

1. Enter a GitHub username.
2. The app fetches user details and contribution data from the GitHub API.
3. It generates an anime-style bounty poster using the Hugging Face Stable Diffusion model.
4. The poster is displayed and ready for download.

Home Page

Generated Bounty Poster

🧩 Tech Stack

• Frontend: Streamlit for an interactive web app.
• Backend APIs:
  • GitHub REST API for fetching user profile data.
  • GitHub GraphQL API for contribution and language statistics.
  • Hugging Face Model (stabilityai/stable-diffusion-3.5-large) for image generation.
  • Docker for Conatinerizing the Application
• Deployment: Hosted on Streamlit Cloud.

🛠️ Local Setup

1. Clone this repository:

   $ git clone https://github.com/Raghul-M/Git-Bounty.git
   $ cd git-bounty

2. Create a virtual environment and activate it:

   $ python -m venv venv
   $ source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. Install dependencies:

   $ pip install -r requirements.txt

4. Set up environment variables:

   • Create a .env file in the project root with the following content:

     GH_TOKEN= "your_github_api_token"
     
     HF_TOKEN= "your_huggingface_api_token"

5. Run the app:

   streamlit run app.py

🧳 Deployment

Streamlit Cloud

1. Push the code to a public/private repository on GitHub.
2. Connect the repository to Streamlit Cloud and deploy the app.

Docker (Optional)

1. Build the Docker image:

   $ docker build -t git-bounty .

2. Run the Docker container:

   $ docker run -p 8501:8501 git-bounty

🌟 Contributing

Contributions are welcome! If you have suggestions, bug reports, or want to add new features, feel free to submit a pull request.

Feel free to explore, contribute, and adapt this project to suit your needs. If you encounter any issues or have suggestions for improvement, please raise them in the GitHub repository's issues section. Happy coding! 🚀

Connect with me on linkedin: Raghul M

✨ Acknowledgments

• Inspired by the creativity of the One Piece universe.
• Special thanks to Streamlit and Hugging Face for their awesome tools.

---

Bring your GitHub activity to life with Git Bounty — the ultimate developer's bounty poster generator! 🏴‍☠️