💰 AWS FinOps CLI (Cost Optimizer)

A lightweight, blazing-fast CLI tool to audit AWS accounts, identify wasted cloud resources, and generate actionable cost-saving reports.

Architecture • Quick Start • Features • CI/CD

---

Stop burning money in the cloud. This tool programmatically connects to your AWS environment, audits specific resource types known for generating "zombie costs", and provides a beautiful terminal report detailing exactly how much money you can save this month by deleting them.

✨ Features

• 📦 Orphaned EBS Volumes: Detects available EBS volumes that are no longer attached to any EC2 instance.
• 🌐 Idle Elastic IPs: Detects EIPs that are provisioned but not associated with a running instance.
• 📊 Rich Reporting: Uses the Python rich library to render beautiful, easy-to-read financial reports in the terminal.
• 🔐 Secure by Default: Adheres to AWS well-architected framework; requires no hardcoded credentials (uses your local ~/.aws/credentials or IAM Roles).

🚀 Quick Start

1. Prerequisites

Ensure you have Python 3.10+ installed and AWS credentials configured via the AWS CLI (aws configure).

2. Installation

git clone https://github.com/your-username/aws-finops-cli.git
cd aws-finops-cli
make install

3. Usage

Run the CLI to audit your default region (us-east-1):

python src/cli.py audit

To audit a specific region:

python src/cli.py audit --region eu-west-1

🛠️ Tech Stack & Architecture

• Core Logic: Python 3, Object-Oriented Design (OOD).
• AWS Integration: boto3 SDK.
• CLI Interface: click for command routing, rich for terminal UI.
• Automation: Makefile for developer workflow encapsulation.

🛡️ CI/CD & Code Quality

This repository utilizes GitHub Actions to ensure code quality on every push:

• Automated syntax checking with flake8.
• Strict code formatting enforcement via black.