{"id":31652941,"url":"https://github.com/siiddhantt/githitbox","last_synced_at":"2026-04-19T15:04:09.245Z","repository":{"id":309952875,"uuid":"1038160759","full_name":"siiddhantt/githitbox","owner":"siiddhantt","description":"A fast, reusable GitHub profile hit counter that generates beautiful badge images","archived":false,"fork":false,"pushed_at":"2025-09-18T13:36:08.000Z","size":60,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-18T15:55:07.687Z","etag":null,"topics":["badge","badge-generator","dynamic-badges","fastapi","github-profile","github-readme","github-readme-stats","github-stats","hit-counter","profile-counter","python","readme-stats"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/siiddhantt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-14T18:06:20.000Z","updated_at":"2025-09-18T13:36:09.000Z","dependencies_parsed_at":"2025-08-14T20:25:09.037Z","dependency_job_id":"59706293-4273-444a-9824-e6cfe155c9f4","html_url":"https://github.com/siiddhantt/githitbox","commit_stats":null,"previous_names":["siiddhantt/githitbox"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/siiddhantt/githitbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siiddhantt%2Fgithitbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siiddhantt%2Fgithitbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siiddhantt%2Fgithitbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siiddhantt%2Fgithitbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siiddhantt","download_url":"https://codeload.github.com/siiddhantt/githitbox/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siiddhantt%2Fgithitbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278762924,"owners_count":26041444,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["badge","badge-generator","dynamic-badges","fastapi","github-profile","github-readme","github-readme-stats","github-stats","hit-counter","profile-counter","python","readme-stats"],"created_at":"2025-10-07T10:39:40.166Z","updated_at":"2025-10-07T10:39:45.324Z","avatar_url":"https://github.com/siiddhantt.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n\n# 🎯 GitHitBox\n\n*A fast, reusable GitHub profile hit counter that generates beautiful badge images*\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg?style=flat\u0026logo=python\u0026logoColor=white)](https://python.org)\n[![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=flat\u0026logo=fastapi)](https://fastapi.tiangolo.com)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat)](https://opensource.org/licenses/MIT)\n\n\u003c/div\u003e\n\n## 🚀 Features\n\n- **🌍 Universal**: Works for any GitHub username\n- **🎨 4 Badge Styles**: flat, plastic, counter, for-the-badge\n- **⚡ Fast**: Built with FastAPI\n- **💾 Persistent**: Database storage (SQLite/PostgreSQL)\n- **🚀 Easy to Deploy**: Works on any hosting platform\n\n## 📖 Usage\n\nAdd to your GitHub profile README:\n\n```markdown\n![Profile Views](https://githitbox.duckdns.org/badge/your-username)\n```\n\n**Styles Available:**\n\n| Style | Example |\n|-------|---------|\n| Flat (default) | ![Flat](https://githitbox.duckdns.org/badge/demo1?v=1) |\n| Plastic | ![Plastic](https://githitbox.duckdns.org/badge/demo2?style=plastic\u0026v=1) |\n| Counter | ![Counter](https://githitbox.duckdns.org/badge/demo3?style=counter\u0026v=1) |\n| For-the-badge | ![Badge](https://githitbox.duckdns.org/badge/demo4?style=for-the-badge\u0026v=1) |\n\n\u003e 💡 **Tip**: Add `?v=2` to bypass GitHub's image cache\n\n## 🛠️ Local Development\n\n```bash\ngit clone https://github.com/siiddhantt/githitbox\ncd githitbox\npip install -r requirements.txt\npython main.py\n```\n\nVisit `http://localhost:3001/docs` for API documentation.\n\n## 🔌 API Endpoints\n\n- `GET /badge/{username}?style={style}` - Badge image\n- `GET /count/{username}` - JSON hit count\n- `GET /stats` - Global statistics\n- `GET /health` - Health check\n\n## ⚙️ Configuration\n\n**Environment Variables:**\n- `DATABASE_URL` - Database connection (defaults to SQLite)\n\n**Badge Styles:**\n- `flat` - Clean, modern (default)\n- `plastic` - Rounded, glossy\n- `counter` - Digital display with dark theme\n- `for-the-badge` - Bold, rectangular\n\n## 📝 License\n\nMIT License - free to use for your projects!\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n⭐ **Star this repo if you find it useful!**\n\n[![GitHub stars](https://img.shields.io/github/stars/siiddhantt/githitbox?style=social)](https://github.com/siiddhantt/githitbox/stargazers)\n\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiiddhantt%2Fgithitbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiiddhantt%2Fgithitbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiiddhantt%2Fgithitbox/lists"}