A Python script to fetch and display the top 400 GitHub user avatars in a sleek, interactive grid. Perfect for exploring the faces behind popular GitHub profiles.
- Fetches GitHub users dynamically via the GitHub API.
- Downloads avatars for offline use.
- Builds a responsive HTML page showcasing all avatars.
- Filters only real users (
type: User) to ensure authentic profiles. - Automatically updates avatars when new versions are available.
- Clean and modern card design using Bootstrap.
Check out the live preview: https://john-bampton.github.io/
- Clone the repository:
git clone https://github.com/john-bampton/john-bampton.github.io.git
cd faces- Install dependencies:
pip install -e .- Run the script:
python github_faces.py- Open the generated HTML page in your browser:
docs/index.html- TARGET_USERS: Number of GitHub users to fetch (default: 400).
- MAX_EXTRA_PAGES: Extra pages to fetch if not enough users are found (default: 2).
You can modify these directly in github_faces.py.
We welcome contributions! Feel free to:
- Submit issues for bugs or feature requests.
- Fork the repository and open pull requests.
- Suggest new ways to improve the avatar grid or functionality.
- Spread the word by adding a ⭐ to this repository.
Inspired by the GitHub community and the creativity of open-source developers. Special thanks to all contributors and avatar owners included in this project.
The idea for this showcase site originally came from the movie 300. The plot revolves around King Leonidas (Gerard Butler), who leads 300 Spartans into battle against the Persian "God-King" Xerxes (Rodrigo Santoro). Here our showcase is currently led by Linus Torvalds.
This project is licensed under the MIT License.
© 2025 John Bampton, and Seyyed Ali Mohammadiyeh (Max Base).
"Explore the faces behind GitHub. Discover the people shaping open-source."