{"id":43305048,"url":"https://github.com/danjamk/slack-aws-cost-guardian","last_synced_at":"2026-02-01T20:13:57.333Z","repository":{"id":333344817,"uuid":"1136831315","full_name":"danjamk/slack-aws-cost-guardian","owner":"danjamk","description":"AI-powered AWS cost monitoring with Slack alerts. Detect spending anomalies, track budgets, get intelligent analysis. Open source, serverless, ~$5/month to run.","archived":false,"fork":false,"pushed_at":"2026-01-19T01:08:51.000Z","size":84,"stargazers_count":0,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-19T01:34:22.393Z","etag":null,"topics":["ai","anomaly-detection","aws","aws-budgets","aws-cdk","aws-cost","claude","cloud-cost","cost-monitoring","cost-optimization","devops","dynamodb","finops","lambda","python","slack","slack-bot"],"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/danjamk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2026-01-18T12:48:15.000Z","updated_at":"2026-01-19T01:08:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/danjamk/slack-aws-cost-guardian","commit_stats":null,"previous_names":["danjamk/slack-aws-cost-guardian"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/danjamk/slack-aws-cost-guardian","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danjamk%2Fslack-aws-cost-guardian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danjamk%2Fslack-aws-cost-guardian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danjamk%2Fslack-aws-cost-guardian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danjamk%2Fslack-aws-cost-guardian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danjamk","download_url":"https://codeload.github.com/danjamk/slack-aws-cost-guardian/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danjamk%2Fslack-aws-cost-guardian/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28988635,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T18:17:03.387Z","status":"ssl_error","status_checked_at":"2026-02-01T18:16:57.287Z","response_time":56,"last_error":"SSL_read: 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":["ai","anomaly-detection","aws","aws-budgets","aws-cdk","aws-cost","claude","cloud-cost","cost-monitoring","cost-optimization","devops","dynamodb","finops","lambda","python","slack","slack-bot"],"created_at":"2026-02-01T20:13:56.842Z","updated_at":"2026-02-01T20:13:57.328Z","avatar_url":"https://github.com/danjamk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Slack AWS Cost Guardian\n![slac-aws-cost-guardian-hero.png](slac-aws-cost-guardian-hero.png)\n\n\u003e AI-powered AWS cost monitoring with Slack alerts\n\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/)\n[![AWS CDK](https://img.shields.io/badge/AWS_CDK-v2-orange.svg)](https://aws.amazon.com/cdk/)\n\nDetect spending anomalies, track budgets, and get intelligent analysis delivered directly to Slack.\n\n## Features\n\n- **Anomaly Detection** - AI-powered identification of unusual spending patterns\n- **Daily \u0026 Weekly Reports** - Automated summaries with budget tracking and forecasts\n- **Interactive Slack Alerts** - Acknowledge costs as expected/unexpected directly from Slack\n- **Budget Threshold Alerts** - Warnings at 80% and critical alerts at 100% of budget\n- **AI Analysis** - Claude or GPT explains what's driving cost changes\n- **@mention Bot** - Ask questions like `@guardian what did we spend yesterday?`\n\n## Quick Start\n\n```bash\n# Clone and setup\ngit clone https://github.com/your-org/slack-aws-cost-guardian.git\ncd slack-aws-cost-guardian\nmake setup\n\n# Configure (edit .env with your Slack webhooks and API keys)\nvim .env\n\n# Deploy\nsource .venv/bin/activate\nmake deploy\n\n# Verify\nmake validate\n```\n\n**Full setup guide**: [docs/SETUP.md](docs/SETUP.md) - includes Slack App configuration, bot setup, and troubleshooting.\n\n## How It Works\n\n```\n┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐\n│   EventBridge   │────▶│     Lambda      │────▶│  Cost Explorer  │\n│   (scheduled)   │     │   (collector)   │     │      API        │\n└─────────────────┘     └────────┬────────┘     └─────────────────┘\n                                 │\n                                 ▼\n                        ┌─────────────────┐\n                        │    DynamoDB     │\n                        │   (snapshots)   │\n                        └────────┬────────┘\n                                 │\n                    ┌────────────┴────────────┐\n                    ▼                         ▼\n           ┌─────────────────┐       ┌─────────────────┐\n           │ Anomaly Detect  │       │   LLM Analysis  │\n           └────────┬────────┘       └────────┬────────┘\n                    │                         │\n                    └────────────┬────────────┘\n                                 ▼\n                        ┌─────────────────┐\n                        │  Slack Alert    │◀───── User Feedback\n                        │  (with buttons) │\n                        └─────────────────┘\n\n┌─────────────────┐     ┌─────────────────┐\n│  Slack @mention │────▶│  Events Lambda  │────▶ Bot Response\n│    or DM        │     │  (with tools)   │\n└─────────────────┘     └─────────────────┘\n```\n\n## Cost to Run\n\nThis tool costs approximately **$2-8/month** depending on your settings:\n\n| Component | Cost | Notes |\n|-----------|------|-------|\n| Cost Explorer API | ~$1.50-6/month | Depends on collection frequency |\n| Secrets Manager | ~$0.40/month | Per secret |\n| DynamoDB | ~$0.05/month | On-demand, minimal storage |\n| Lambda/S3 | ~$0/month | Free tier covers it |\n| LLM API (optional) | ~$0.30-1.00/month | For AI insights |\n\nSee `config/config.example.yaml` for detailed cost breakdown and optimization tips.\n\n## Configuration\n\n### Application Settings\n\nCopy and customize the config file:\n\n```bash\ncp config/config.example.yaml config/config.yaml\n```\n\nKey settings:\n- **Collection frequency** - How often to fetch costs (daily recommended)\n- **Budget thresholds** - When to alert (80%, 100%)\n- **Anomaly sensitivity** - What triggers an alert ($10 change, 50% increase)\n\n### AI Context\n\nCustomize the AI's understanding of your infrastructure:\n\n```bash\nvim config/guardian-context.md\nmake update-context\n```\n\n## Documentation\n\n- **[Setup Guide](docs/SETUP.md)** - Complete installation and configuration\n- **[Architecture](docs/ARCHITECTURE.md)** - Technical reference and data models\n- **[Backlog](docs/BACKLOG.md)** - Roadmap and planned features\n\n## Common Commands\n\n```bash\nmake help              # Show all commands\nmake deploy            # Deploy to AWS\nmake validate          # Verify configuration\nmake test-daily        # Send daily report\nmake logs              # Tail collector logs\nmake logs-events       # Tail bot logs\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanjamk%2Fslack-aws-cost-guardian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanjamk%2Fslack-aws-cost-guardian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanjamk%2Fslack-aws-cost-guardian/lists"}