{"id":23592543,"url":"https://github.com/rmncldyo/github-stats-checker","last_synced_at":"2025-10-26T10:40:33.297Z","repository":{"id":268930851,"uuid":"905894100","full_name":"RMNCLDYO/github-stats-checker","owner":"RMNCLDYO","description":"A Python tool for analyzing GitHub profiles and repository statistics.","archived":false,"fork":false,"pushed_at":"2024-12-21T02:48:02.000Z","size":32,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-27T08:14:15.656Z","etag":null,"topics":["forks","git","github","github-forks","github-profile","github-stars","github-stat","github-statistics","github-stats","github-watchers","private-repo","private-repository","profile-analyzer","public-repo","public-repository","repo-stats","repository","repository-stats","stars","watchers"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RMNCLDYO.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-19T18:28:58.000Z","updated_at":"2024-12-21T02:48:05.000Z","dependencies_parsed_at":"2024-12-19T19:34:19.508Z","dependency_job_id":"98c654c6-3908-4b7f-9006-128481b7d6db","html_url":"https://github.com/RMNCLDYO/github-stats-checker","commit_stats":null,"previous_names":["rmncldyo/github-stats-checker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2Fgithub-stats-checker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2Fgithub-stats-checker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2Fgithub-stats-checker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2Fgithub-stats-checker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RMNCLDYO","download_url":"https://codeload.github.com/RMNCLDYO/github-stats-checker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239432734,"owners_count":19637798,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["forks","git","github","github-forks","github-profile","github-stars","github-stat","github-statistics","github-stats","github-watchers","private-repo","private-repository","profile-analyzer","public-repo","public-repository","repo-stats","repository","repository-stats","stars","watchers"],"created_at":"2024-12-27T08:14:23.365Z","updated_at":"2025-09-22T23:36:13.014Z","avatar_url":"https://github.com/RMNCLDYO.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/\" title=\"Go to GitHub homepage\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/GitHub-fafafa?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIzMiIgaGVpZ2h0PSIzMiIgdmlld0JveD0iMCAwIDMyIDMyIiBmaWxsPSJub25lIj4KICAgIDxwYXRoIGZpbGwtcnVsZT0iZXZlbm9kZCIgY2xpcC1ydWxlPSJldmVub2RkIiBkPSJNMTYgMEM3LjE2IDAgMCA3LjE2IDAgMTZDMCAyMy4wOCA0LjU4IDI5LjA2IDEwLjk0IDMxLjE4QzExLjc0IDMxLjMyIDEyLjA0IDMwLjg0IDEyLjA0IDMwLjQyQzEyLjA0IDMwLjA0IDEyLjAyIDI4Ljc4IDEyLjAyIDI3LjQ0QzggMjguMTggNi45NiAyNi40NiA2LjY0IDI1LjU2QzYuNDYgMjUuMSA1LjY4IDIzLjY4IDUgMjMuM0M0LjQ0IDIzIDMuNjQgMjIuMjYgNC45OCAyMi4yNEM2LjI0IDIyLjIyIDcuMTQgMjMuNCA3LjQ0IDIzLjg4QzguODggMjYuMyAxMS4xOCAyNS42MiAxMi4xIDI1LjJDMTIuMjQgMjQuMTYgMTIuNjYgMjMuNDYgMTMuMTIgMjMuMDZDOS41NiAyMi42NiA1Ljg0IDIxLjI4IDUuODQgMTUuMTZDNS44NCAxMy40MiA2LjQ2IDExLjk4IDcuNDggMTAuODZDNy4zMiAxMC40NiA2Ljc2IDguODIgNy42NCA2LjYyQzcuNjQgNi42MiA4Ljk4IDYuMiAxMi4wNCA4LjI2QzEzLjMyIDcuOSAxNC42OCA3LjcyIDE2LjA0IDcuNzJDMTcuNCA3LjcyIDE4Ljc2IDcuOSAyMC4wNCA4LjI2QzIzLjEgNi4xOCAyNC40NCA2LjYyIDI0LjQ0IDYuNjJDMjUuMzIgOC44MiAyNC43NiAxMC40NiAyNC42IDEwLjg2QzI1LjYyIDExLjk4IDI2LjI0IDEzLjQgMjYuMjQgMTUuMTZDMjYuMjQgMjEuMyAyMi41IDIyLjY2IDE4Ljk0IDIzLjA2QzE5LjUyIDIzLjU2IDIwLjAyIDI0LjUyIDIwLjAyIDI2LjAyQzIwLjAyIDI4LjE2IDIwIDI5Ljg4IDIwIDMwLjQyQzIwIDMwLjg0IDIwLjMgMzEuMzQgMjEuMSAzMS4xOEMyNy40MiAyOS4wNiAzMiAyMy4wNiAzMiAxNkMzMiA3LjE2IDI0Ljg0IDAgMTYgMFYwWiIgZmlsbD0iIzI0MjkyRSIvPgo8L3N2Zz4=\" alt=\"GitHub\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/RMNCLDYO/github-stats-checker\" title=\"Go to repo\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/dynamic/json?style=for-the-badge\u0026label=GitHub%20Stats%20Checker\u0026query=version\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2FRMNCLDYO%2Fgithub-stats-checker%2Fmain%2F.github%2Fversion.json\" alt=\"GitHub Stats Checker\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\".github/CHANGELOG.md\" title=\"Go to changelog\"\u003e\u003cimg src=\"https://img.shields.io/badge/maintained-yes-2ea44f?style=for-the-badge\" alt=\"maintained - yes\"\u003e\u003c/a\u003e\n    \u003ca href=\".github/CONTRIBUTING.md\" title=\"Go to contributions doc\"\u003e\u003cimg src=\"https://img.shields.io/badge/contributions-welcome-2ea44f?style=for-the-badge\" alt=\"contributions - welcome\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"/\"\u003e\n        \u003cpicture\u003e\n          \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/RMNCLDYO/github-stats-checker/main/.github/github-logo-dark.png\"\u003e\n          \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/RMNCLDYO/github-stats-checker/main/.github/github-logo-light.png\"\u003e\n          \u003cimg alt=\"GitHub\" width=\"250\" src=\"https://raw.githubusercontent.com/RMNCLDYO/github-stats-checker/main/.github/github-logo-dark.png\"\u003e\n        \u003c/picture\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\nA Python tool for analyzing GitHub profiles and repository statistics. This tool allows you to fetch comprehensive statistics about any GitHub user's repositories, including stars, forks, watchers, and more.\n\n## 🚀 Features\n\n- 📊 **Profile Analytics**: Fetch comprehensive GitHub user profile information and statistics\n- 📈 **Repository Stats**: Analyze stars, forks, watchers, and other metrics for repositories\n- 🔒 **Private Repos**: Support for private repository access with proper authentication\n- 🪶 **Lightweight Design**: Minimal dependencies for easy setup and deployment\n- 🔒 **Robust Error Handling**: Comprehensive error catching and validation\n\n## 📋 Table of Contents\n\n- [Installation](#-installation)\n- [Authentication](#-authentication-optional)\n- [Configuration](#-configuration-optional)\n- [Usage](#-usage)\n- [Advanced Configuration](#%EF%B8%8F-advanced-configuration)\n- [Error Handling and Safety](#-error-handling-and-safety)\n- [Contributing](#-contributing)\n- [Issues and Support](#-issues-and-support)\n- [Feature Requests](#-feature-requests)\n- [Versioning and Changelog](#-versioning-and-changelog)\n- [Security](#-security)\n- [License](#-license)\n\n## 🛠 Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/RMNCLDYO/github-stats-checker.git\n   ```\n\n2. Navigate to the repository folder:\n   ```bash\n   cd github-stats-checker\n   ```\n\n3. Install the required dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n## 🔒 Authentication (*Optional*)\n\nIn order to access private repositories, you must provide a personal access token with the `read:user` scope selected.\n\n\u003e [!IMPORTANT]  \n\u003e Without a personal access token, this tool will not be able to access private repositories.\n\n## 🔑 Configuration (*Optional*)\n1. Obtain an access token from [GitHub](https://github.com/settings/tokens).\n2. You have three options for managing your access token:\n   \u003cdetails\u003e\n   \u003csummary\u003eClick here to view the access token configuration options\u003c/summary\u003e\n   \n   - **Setting it as an environment variable on your device (recommended for everyday use)**\n       - Navigate to your terminal.\n       - Add your access token like so:\n         ```shell\n         export GITHUB_ACCESS_TOKEN=YOUR_GITHUB_ACCESS_TOKEN_HERE\n         ```\n       This method allows the access token to be loaded automatically when using the wrapper.\n     \n   - **Using an .env file (recommended for development):**\n       - Install python-dotenv if you haven't already: `pip install python-dotenv`.\n       - Create a .env file in the project's root directory or rename `example.env` to `.env`.\n       - Add your access token to the .env file like so:\n         ```makefile\n         GITHUB_ACCESS_TOKEN=YOUR_GITHUB_ACCESS_TOKEN_HERE\n         ```\n       This method allows the access token to be loaded automatically when using the wrapper.\n   \u003c/details\u003e\n\n## 💻 Usage\n\n```python\nimport github\n\ngithub.crawl()\n```\n\n## ⚙️ Advanced Configuration\n\n*You can customize the behavior of the tool by modifying the `config.yaml` file in the root directory of the repository.*\n\n| Option | Type | Description | Default |\n|--------|------|-------------|---------|\n| `repo_limit` | Integer | Maximum repositories to analyze | `100` |\n| `include_private_repos` | Boolean | Include private repositories | `false` |\n| `include_forks` | Boolean | Include forked repositories | `true` |\n| `include_stars` | Boolean | Include repository stars | `true` |\n| `include_watchers` | Boolean | Include repository watchers | `true` |\n| `include_overall_totals` | Boolean | Show combined statistics | `true` |\n| `include_individual_totals` | Boolean | Show per-repository stats | `true` |\n| `timeout` | Integer | API request timeout (seconds) | `10` |\n\n## 🔒 Error Handling and Safety\n\n| Error Type | Description | Solution |\n|------------|-------------|----------|\n| `TokenError` | Invalid/missing token | Check token permissions |\n| `ConfigError` | Configuration issues | Verify config.yaml |\n| `RateLimitError` | API rate limiting | Wait or use authentication |\n| `NetworkError` | Connection issues | Check internet connection |\n| `ValidationError` | Invalid parameters | Verify input parameters |\n\n## 🤝 Contributing\nContributions are welcome!\n\nPlease refer to [CONTRIBUTING.md](.github/CONTRIBUTING.md) for detailed guidelines on how to contribute to this project.\n\n## 🐛 Issues and Support\nEncountered a bug? We'd love to hear about it. Please follow these steps to report any issues:\n\n1. Check if the issue has already been reported.\n2. Use the [Bug Report](.github/ISSUE_TEMPLATE/bug_report.md) template to create a detailed report.\n3. Submit the report [here](https://github.com/RMNCLDYO/github-stats-checker/issues).\n\nYour report will help us make the project better for everyone.\n\n## 💡 Feature Requests\nGot an idea for a new feature? Feel free to suggest it. Here's how:\n\n1. Check if the feature has already been suggested or implemented.\n2. Use the [Feature Request](.github/ISSUE_TEMPLATE/feature_request.md) template to create a detailed request.\n3. Submit the request [here](https://github.com/RMNCLDYO/github-stats-checker/issues).\n\nYour suggestions for improvements are always welcome.\n\n## 🔁 Versioning and Changelog\nStay up-to-date with the latest changes and improvements in each version:\n\n- [CHANGELOG.md](.github/CHANGELOG.md) provides detailed descriptions of each release.\n\n## 🔐 Security\nYour security is important to us. If you discover a security vulnerability, please follow our responsible disclosure guidelines found in [SECURITY.md](.github/SECURITY.md). Please refrain from disclosing any vulnerabilities publicly until said vulnerability has been reported and addressed.\n\n## 📄 License\nLicensed under the MIT License. See [LICENSE](LICENSE) for details.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmncldyo%2Fgithub-stats-checker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frmncldyo%2Fgithub-stats-checker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmncldyo%2Fgithub-stats-checker/lists"}