{"id":37179810,"url":"https://github.com/x-sushant-x/rate-shield","last_synced_at":"2026-01-14T20:55:10.344Z","repository":{"id":251689590,"uuid":"838142615","full_name":"x-sushant-x/Rate-Shield","owner":"x-sushant-x","description":"A configurable rate limiter that can apply rate limiting on individual APIs with individual rules.","archived":false,"fork":false,"pushed_at":"2025-11-13T05:43:50.000Z","size":741,"stargazers_count":174,"open_issues_count":10,"forks_count":17,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-13T06:18:28.243Z","etag":null,"topics":["golang","hacktoberfest","hacktoberfest-accepted","javascript","typescript"],"latest_commit_sha":null,"homepage":"https://beyondthesyntax.substack.com/p/i-made-a-configurable-rate-limiter","language":"Go","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/x-sushant-x.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-08-05T03:15:21.000Z","updated_at":"2025-11-13T05:54:36.000Z","dependencies_parsed_at":"2024-10-24T21:06:41.455Z","dependency_job_id":"66ce05e4-bd08-45e5-837f-091e617fc513","html_url":"https://github.com/x-sushant-x/Rate-Shield","commit_stats":null,"previous_names":["x-sushant-x/throttle-watch"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/x-sushant-x/Rate-Shield","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-sushant-x%2FRate-Shield","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-sushant-x%2FRate-Shield/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-sushant-x%2FRate-Shield/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-sushant-x%2FRate-Shield/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/x-sushant-x","download_url":"https://codeload.github.com/x-sushant-x/Rate-Shield/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-sushant-x%2FRate-Shield/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28434500,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T18:57:19.464Z","status":"ssl_error","status_checked_at":"2026-01-14T18:52:48.501Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["golang","hacktoberfest","hacktoberfest-accepted","javascript","typescript"],"created_at":"2026-01-14T20:55:09.801Z","updated_at":"2026-01-14T20:55:10.335Z","avatar_url":"https://github.com/x-sushant-x.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"## 🚀 **RateShield**\n\nA fully customizable rate limiter designed to apply rate limiting on individual APIs with specific rules.\n\n\n#### 📊 **Dashboard Overview**\n\n![RateShield Dashboard](https://raw.githubusercontent.com/x-sushant-x/Rate-Shield/main/assets/main.png)\n\n\n![RateShield Edit Rule](https://raw.githubusercontent.com/x-sushant-x/Rate-Shield/main/assets/Edit%20Rule.png)\n\n___\n\n#### 🎯 **Why RateShield?**\n\nWhy not? With some free time on hand, RateShield was created to explore the potential of building a versatile rate-limiting solution. What started as a side project is evolving into a powerful tool for developers.\n\n---\n\n#### 🌟 **Key Features**\n\n- **Customizable Limiting:** \u003cbr\u003e\n   Tailor rate limiting rules to each API endpoint according to your needs.\n   \n- **Intuitive Dashboard:** \u003cbr\u003e\n   A user-friendly interface to monitor and manage all your rate limits effectively.\n   \n- **Easy Integration:** \u003cbr\u003e\n   Plug-and-play middleware that seamlessly integrates into your existing infrastructure.\n\n---\n\n#### ⚙️ **Use Cases**\n\n- **Preventing Abuse:**  \n  Control the number of requests your APIs can handle to prevent misuse and malicious activities.\n  \n- **Cost Management:**  \n  Manage third-party API calls efficiently to avoid unexpected overages.\n\n---\n\n#### 🚀 **Supported Rate Limiting Algorithms**\n\n- **Token Bucket**\n- **Fixed Window Counter**\n- **Sliding Window**\n\n---\n\n#### 🪧 Usage Guide\n  Check out this [document](https://github.com/x-sushant-x/Rate-Shield/tree/main/rate_shield/documentation).\n\n---\n\n### A detailed blog post about its working.\n[Read Here](https://beyondthesyntax.substack.com/p/i-made-a-configurable-rate-limiter)\n\n---\n\n#### How it works?\n\u003cimg src=\"https://raw.githubusercontent.com/x-sushant-x/Rate-Shield/main/assets/architecture.png\"\u003e\u003c/img\u003e\n\n---\n\n#### 📋 **Prerequisites**\n\nBefore setting up RateShield, ensure you have the following:\n\n- **Docker \u0026 Docker Compose** - Required for running the application and Redis infrastructure\n- **Redis Stack** (included in docker-compose):\n  - Single Redis instance for storing rate limit rules (port 6379)\n  - Redis Cluster with 6 nodes (3 masters + 3 replicas) for distributed rate limiting (ports 7000-7005)\n  - ReJSON module enabled (automatically included with redis/redis-stack image)\n- **Slack Integration** (for error notifications):\n  - Slack Bot Token\n  - Slack Channel ID\n\n**Quick Start with Docker Compose:**\n\nThe provided `docker-compose.yml` includes everything you need - no separate Redis setup required!\n\n```bash\ncd rate_shield\ncp .env.example .env\n# Edit .env with your Slack credentials\ndocker-compose up -d\n```\n\nFor detailed setup instructions, see [SETUP.md](SETUP.md).\n\n ---\n\n#### 🤝 **Contributing**\n\nInterested in contributing? We'd love your help! Check out our [Contribution Guidelines](https://github.com/x-sushant-x/Rate-Shield/blob/main/CONTRIBUTION.md) to get started.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-sushant-x%2Frate-shield","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fx-sushant-x%2Frate-shield","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-sushant-x%2Frate-shield/lists"}