Skip to content

rahulbanerjee26/githubProfileReadmeGenerator

Repository files navigation

GitHub Profile README / About Me Generator 💯

forthebadge made-with-python Github Profile README Generator - A Few inputs+ ~15mins= Github Profile reaches a new level 🔥 | Product Hunt Streamlit-Badge

This web app lets you build a cool README for your profile.

Screencast of Github AboutMe/Profile ReadMe Generator

A few inputs + ~15 mins = Your GitHub Profile reaches a new level 🔥

Live 🌞

Go to - Live Site

Article 📝

The article contains resources for GIFs, royalty free images/icons and tutorials on how to create your secret repo for the About Me Page, setting up the blog flow action etc.

Usage 🔧

  • Fill in the text boxes. Leave the ones you do not wish to fill blank.
  • By default the generated ReadMe has GitHub stats and Wakatime stats, feel free to remove them.
  • If you want to build on top of the Readme, refer to the article I mentioned above for resources and tips
  • If you used this app to build your README, consider adding yourself to the "Users who used this app to generate a README" section. You can showcase your README and others will be able to view it and star it. You are guaranteed a star from me ⭐

Built With 🧰

Features 💿

  • GIFs
  • Social Icons
  • Skill Icons
  • Visitors Badge
  • Github Stats
  • WakaTime Stats
  • .yml file to display Blog Posts from your feed
  • Ability to add image banners at beginning of README
  • Random Jokes Card

Update 05-01-2020 🗓

  • Clicking on Skills shows your github repos filtered on that skill
  • Chose GitHub Stats Card Type
  • Cool Image in About Me section
  • Fixed styling
  • Added Default Content

Running Locally 🖥️

  1. Clone the repo or your fork.

  2. Create a virtual environment

    python -m venv venv
  3. Activate the virtual environment ` ```sh

    Windows

    venv/Scripts/activate

    Linux/macOS

    source venv/bin/activate

  4. Install required dependencies

    pip install -r requirements.txt
  5. Run the App

    streamlit run __init__.py

Contributors ✨

Contributing 🤝

Feature Suggestion and Problems 💎

Go to Issues on the repo.

  • Create an explaining the Feature.
  • If you find any errors/issues, feel free to create an Issue.

Pull Requests 🔀

How to make code changes and add them to this repo with a Pull Request.

  1. Fork the Project
  2. Clone it using the URL from the Code button.
    git clone FORK_URL
  3. Create your Feature Branch
    git checkout -b feat-my-feature
  4. Commit your Changes
    git commit -m 'Add some Amazing Feature'
  5. Push to the Branch
    git push origin feat-my-feature
  6. Go to Pull Requests of the original repo.
  7. Create a Pull Request. Compare across forks and pick your fork and your branch.

Once your PR is merged, I will add you as a contributor :)

Or if you wish to add yourself to 'Users who used this app' list, simply fork the repo, update the README and make a PR. Follow this format:

- <a href = 'https://github.com/USERNAME'> DISPLAY NAME </a>

Or just reach out to me on Twitter/LinkedIn and I'll add you :)

Plans for future release 📆

  • Adding more badges
  • Giving user ability to chose between different ReadMe designs
  • Increasing number of social Icons

Users who used this app to generate a README 🌠

License ⚖️

  • Distributed under the MIT License. See LICENSE for more information.

Resources