GitHub는 오픈소스 커뮤니티와 개발자들에게 없어서는 안 될 플랫폼입니다. 그러나, 많은 개발자들이 GitHub 프로필을 통해 자신이 기여한 내용을 정확하게 표현하지 못하는 경우가 많습니다. 기존의 프로필 통계는 개인의 오픈소스 기여뿐 아니라, 비공식적인 사적 기여도 누락되기 일쑤입니다. 이를 해결하기 위해 등장한 프로젝트가 바로 GitHub Stats Visualization입니다. 이 프로젝트는 GitHub API를 이용해 사용자와 리포지토리의 통계를 시각적으로 보여주는 이미지 생성기를 제공합니다. 이제 나의 GitHub 활동을 더욱 멋지게 표현해보세요!
GitHub Stats Visualization의 주요 기능
이 프로젝트는 다양한 기능을 제공합니다:
- 정확한 통계 수집: 개인이 소유하지 않은 비공식 리포지토리와 비공식적인 기여까지 포함하여 통계를 수집합니다.
- 다양한 이미지 생성: 통계 이미지는 GitHub의 라이트 테마와 다크 테마에 맞춰 자동으로 전환됩니다.
- GitHub Actions 기반: 서버 없이 GitHub Actions를 통해 이미지가 정기적으로 갱신됩니다.
- JSON 데이터 출력: 모든 통계는 JSON 파일로 저장되어 추가 데이터 분석에 사용할 수 있습니다.
GITHUB_TOKEN: 위에서 생성한 GitHub 액세스 토큰- 오픈소스 프로젝트에 기여하는 모든 개발자
- 자신만의 GitHub 프로필을 더욱 매력적으로 만들고 싶은 사용자
- 통계 기반의 데이터를 통해 자신의 활동을 분석하고자 하는 사람들
이제 이 오픈소스 프로젝트를 설치하고 사용하는 방법을 알아보겠습니다.
설치 및 빠른 시작 가이드
1. 리포지토리 클론하기
우선, git 명령어를 사용하여 리포지토리를 클론합니다.
git clone https://github.com/jstrieb/github-stats.git
cd github-stats
2. GitHub 액세스 토큰 생성
프로젝트를 사용하기 위해서는 GitHub 액세스 토큰이 필요합니다. 여기에서 개인 액세스 토큰을 생성하세요. 필요한 권한을 설정하는 것을 잊지 마세요!
3. GitHub Actions 설정
리포지토리의 .github/workflows 폴더 안에 있는 workflow 파일을 수정하여 액세스 토큰을 설정합니다. GitHub Secrets에 다음과 같은 변수를 추가하세요:
4. 이미지 생성하기
이제 GitHub Actions가 자동으로 실행되어 통계 이미지를 생성합니다. 통계 이미지는 리포지토리의 README.md 파일에 추가할 수 있습니다.

위 코드를 README.md 파일에 추가하면, 당신의 프로필에 멋진 통계 이미지를 나타낼 수 있습니다!
실무 활용 시나리오
이 도구는 개인 포트폴리오를 강화하고, 오픈소스 기여를 강조하는 데에 매우 유용합니다. 예를 들어, 프리랜서 개발자나 오픈소스 프로젝트에 기여하는 개발자들은 이 통계 이미지를 사용하여 자신의 기여도를 실질적으로 표현할 수 있습니다. 또한, 기업에서 내 이력을 검토할 때, 이러한 시각적 통계는 더 많은 주목을 받을 수 있습니다.
비슷한 도구와 비교
비슷한 도구로는 shields.io와 GitHub Readme Stats가 있지만, 이 두 도구는 기본적으로 공개 리포지토리의 통계만 제공하며, 비공식적인 기여나 개인적인 통계를 정확하게 수집하는 데는 한계가 있습니다. 반면, GitHub Stats Visualization은 개인의 모든 기여를 포괄적으로 표현할 수 있어, 더 많은 가치를 제공합니다.
추천 대상
이 도구는 다음과 같은 분들에게 추천합니다:
마지막으로, GitHub Stats Visualization으로 나의 GitHub 프로필을 한층 더 매력적으로 만들어 보세요! 사용이 간편한 이 도구는 당신의 기여를 더욱 빛나게 할 것입니다.
더 자세한 내용은 GitHub Stats Visualization 리포지토리에서 확인하실 수 있습니다.