Are you curious about showcasing your GitHub contributions? The GitHub Stats Visualization project is your answer! This tool enables users to generate visual representations of profile and repository statistics right on their profile or in a repository README. In this guide, we’ll explore how to set up this visualization using GitHub Actions, while also covering potential troubleshooting tips along the way.

Why Do You Need GitHub Stats Visualization?

• Gain insights into contributions that go beyond public repositories.
• Automatically updated images without requires server setup.
• Highlight contributions in both light and dark themes seamlessly.

Getting Started

Let’s dive into how you can set up GitHub Stats Visualization.

1. Create a Personal Access Token

The first step on your journey is to create a personal access token. You can use the instructions provided here. Ensure that your token has the required permissions:

• read:user
• repo

Don’t forget to copy your access token as it cannot be retrieved again!

2. Duplicate the Repository

Create a fresh copy of the GitHub Stats Visualization repository by clicking here. Remember, this isn’t the same as forking!

3. Set Up Secrets

Navigate to the Secrets page in your repository settings:

1. Click on Settings > Secrets.
2. Create a new secret named ACCESS_TOKEN and paste your personal access token as the value.

4. Customize Statistics

You can customize the statistics reported by creating additional secrets:

• To ignore certain repositories, add them to a new secret named EXCLUDED.
• To ignore languages, create a secret called EXCLUDED_LANGS.
• For statistics relating to owned repositories only, set an EXCLUDE_FORKED_REPOS variable in your workflow.

5. Triggering the Workflow

Head over to the Actions Page and click on Run Workflow to generate your images. The images will automatically update every 24 hours.

6. Use Your Visualizations

To add these images to your GitHub Profile README, simply include the following markdown, replacing username with your actual GitHub username:

![](https://raw.githubusercontent.com/username/github-stats/master/generated/overview.svg#gh-dark-mode-only)
![](https://raw.githubusercontent.com/username/github-stats/master/generated/overview.svg#gh-light-mode-only) 
![](https://raw.githubusercontent.com/username/github-stats/master/generated/languages.svg#gh-dark-mode-only) 
![](https://raw.githubusercontent.com/username/github-stats/master/generated/languages.svg#gh-light-mode-only)

7. Link and Support

Finally, don’t forget to link back to this repository, allowing others to create their own statistics images. If you enjoyed using this tool, consider starring the repository!

Troubleshooting Tips

While setting up your GitHub Stats Visualization, you may encounter some hiccups. Here are some troubleshooting ideas:

• If your personal access token doesn’t work immediately, be patient; it may take a few minutes before it’s active. Refer to issue #30 for more information.
• Check for any permission-related issues with your access token, ensuring it has read permissions for both user and repository data.
• Be aware of potential inaccuracies in the statistics reported by GitHub’s API. This is usually driven by caching and may improve over time. More details on inaccuracies can be found in issues #2, #3, and #13.

For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.

Conclusion

At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.