https://github.com/danjamk/slack-aws-cost-guardian
AI-powered AWS cost monitoring with Slack alerts. Detect spending anomalies, track budgets, get intelligent analysis. Open source, serverless, ~$5/month to run.
https://github.com/danjamk/slack-aws-cost-guardian
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
Last synced: 5 months ago
JSON representation
AI-powered AWS cost monitoring with Slack alerts. Detect spending anomalies, track budgets, get intelligent analysis. Open source, serverless, ~$5/month to run.
- Host: GitHub
- URL: https://github.com/danjamk/slack-aws-cost-guardian
- Owner: danjamk
- License: mit
- Created: 2026-01-18T12:48:15.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-19T01:08:51.000Z (5 months ago)
- Last Synced: 2026-01-19T01:34:22.393Z (5 months ago)
- 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
- Language: Python
- Homepage:
- Size: 82 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Slack AWS Cost Guardian
> AI-powered AWS cost monitoring with Slack alerts
[](LICENSE)
[](https://www.python.org/downloads/)
[](https://aws.amazon.com/cdk/)
Detect spending anomalies, track budgets, and get intelligent analysis delivered directly to Slack.
## Features
- **Anomaly Detection** - AI-powered identification of unusual spending patterns
- **Daily & Weekly Reports** - Automated summaries with budget tracking and forecasts
- **Interactive Slack Alerts** - Acknowledge costs as expected/unexpected directly from Slack
- **Budget Threshold Alerts** - Warnings at 80% and critical alerts at 100% of budget
- **AI Analysis** - Claude or GPT explains what's driving cost changes
- **@mention Bot** - Ask questions like `@guardian what did we spend yesterday?`
## Quick Start
```bash
# Clone and setup
git clone https://github.com/your-org/slack-aws-cost-guardian.git
cd slack-aws-cost-guardian
make setup
# Configure (edit .env with your Slack webhooks and API keys)
vim .env
# Deploy
source .venv/bin/activate
make deploy
# Verify
make validate
```
**Full setup guide**: [docs/SETUP.md](docs/SETUP.md) - includes Slack App configuration, bot setup, and troubleshooting.
## How It Works
```
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ EventBridge │────▶│ Lambda │────▶│ Cost Explorer │
│ (scheduled) │ │ (collector) │ │ API │
└─────────────────┘ └────────┬────────┘ └─────────────────┘
│
▼
┌─────────────────┐
│ DynamoDB │
│ (snapshots) │
└────────┬────────┘
│
┌────────────┴────────────┐
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ Anomaly Detect │ │ LLM Analysis │
└────────┬────────┘ └────────┬────────┘
│ │
└────────────┬────────────┘
▼
┌─────────────────┐
│ Slack Alert │◀───── User Feedback
│ (with buttons) │
└─────────────────┘
┌─────────────────┐ ┌─────────────────┐
│ Slack @mention │────▶│ Events Lambda │────▶ Bot Response
│ or DM │ │ (with tools) │
└─────────────────┘ └─────────────────┘
```
## Cost to Run
This tool costs approximately **$2-8/month** depending on your settings:
| Component | Cost | Notes |
|-----------|------|-------|
| Cost Explorer API | ~$1.50-6/month | Depends on collection frequency |
| Secrets Manager | ~$0.40/month | Per secret |
| DynamoDB | ~$0.05/month | On-demand, minimal storage |
| Lambda/S3 | ~$0/month | Free tier covers it |
| LLM API (optional) | ~$0.30-1.00/month | For AI insights |
See `config/config.example.yaml` for detailed cost breakdown and optimization tips.
## Configuration
### Application Settings
Copy and customize the config file:
```bash
cp config/config.example.yaml config/config.yaml
```
Key settings:
- **Collection frequency** - How often to fetch costs (daily recommended)
- **Budget thresholds** - When to alert (80%, 100%)
- **Anomaly sensitivity** - What triggers an alert ($10 change, 50% increase)
### AI Context
Customize the AI's understanding of your infrastructure:
```bash
vim config/guardian-context.md
make update-context
```
## Documentation
- **[Setup Guide](docs/SETUP.md)** - Complete installation and configuration
- **[Architecture](docs/ARCHITECTURE.md)** - Technical reference and data models
- **[Backlog](docs/BACKLOG.md)** - Roadmap and planned features
## Common Commands
```bash
make help # Show all commands
make deploy # Deploy to AWS
make validate # Verify configuration
make test-daily # Send daily report
make logs # Tail collector logs
make logs-events # Tail bot logs
```
## License
MIT License - see [LICENSE](LICENSE) for details.