https://github.com/raghul-m/git-bounty
Git Bounty 🏴☠️, a fun and creative tool that transforms GitHub profiles into vibrant anime-style bounty posters. Simply enter a GitHub username to generate a unique poster based on contributions, favorite programming languages, and more!
https://github.com/raghul-m/git-bounty
github-api graphql huggingface huggingface-models python stability-ai streamlit-webapp
Last synced: 2 months ago
JSON representation
Git Bounty 🏴☠️, a fun and creative tool that transforms GitHub profiles into vibrant anime-style bounty posters. Simply enter a GitHub username to generate a unique poster based on contributions, favorite programming languages, and more!
- Host: GitHub
- URL: https://github.com/raghul-m/git-bounty
- Owner: Raghul-M
- License: mit
- Created: 2025-01-21T20:21:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-09T16:21:26.000Z (12 months ago)
- Last Synced: 2025-07-10T01:19:17.535Z (12 months ago)
- Topics: github-api, graphql, huggingface, huggingface-models, python, stability-ai, streamlit-webapp
- Language: Python
- Homepage: https://gitbounty.streamlit.app/
- Size: 77.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Git Bounty 💰
**Git Bounty** generates a 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/](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](https://streamlit.io/) for an interactive web app.
- **Backend APIs**:
- [GitHub REST API](https://docs.github.com/en/rest) for fetching user profile data.
- [GitHub GraphQL API](https://docs.github.com/en/graphql) for contribution and language statistics.
- [Hugging Face Model (stabilityai/stable-diffusion-3.5-large)](https://huggingface.co/stabilityai) for image generation.
- [Docker](https://www.docker.com/) for Conatinerizing the Application
- **Deployment**: Hosted on [Streamlit Cloud](https://streamlit.io/cloud).
## 🛠️ Local Setup
1. Clone this repository:
```bash
$ git clone https://github.com/Raghul-M/Git-Bounty.git
$ cd git-bounty
```
2. Create a virtual environment and activate it:
```bash
$ python -m venv venv
$ source venv/bin/activate # On Windows, use `venv\Scripts\activate`
```
3. Install dependencies:
```bash
$ pip install -r requirements.txt
```
4. Set up environment variables:
- Create a `.env` file in the project root with the following content:
```env
GH_TOKEN= "your_github_api_token"
HF_TOKEN= "your_huggingface_api_token"
```
5. Run the app:
```bash
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](https://streamlit.io/cloud) and deploy the app.
### Docker (Optional)
1. Build the Docker image:
```bash
$ docker build -t git-bounty .
```
2. Run the Docker container:
```bash
$ 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](https://www.linkedin.com/in/m-raghul/)
## ✨ Acknowledgments
- Inspired by the creativity of the One Piece universe.
- Special thanks to [Streamlit](https://streamlit.io/) and [Hugging Face](https://huggingface.co/) for their awesome tools.
---
Bring your GitHub activity to life with **Git Bounty** — the ultimate developer's bounty poster generator! 🏴☠️