AWS Cloud Cost Auditor & FinOps Toolkit
A zero-agent, production-grade CLI suite designed to audit AWS infrastructure for orphaned resources, calculate monthly financial drag, synthesize remediation bash scripts, and generate branded executive PDF showbacks.
Prerequisites
- Python 3.10+
- AWS CLI configured with appropriate permissions (
aws configureor standard AWS environment variables:AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY,AWS_REGION).
Installation
Extract your purchased archive, navigate into the directory, and install dependencies:
pip install -r requirements.txt
1. Practitioner Quickstart (Single-Account Audits)
Included in Practitioner & Agency tiers (
infrastructure_auditor.py)
Audit the active AWS account configured in your local environment.
Run Audit Against Live AWS Infrastructure
python infrastructure_auditor.py --compliance --remediate
Run in Demo / Offline Mode (Using Sample Dataset)
python infrastructure_auditor.py --file sample_aws_data.csv --compliance --remediate
Outputs Generated:
- Terminal Summary: Categorized breakdown of orphaned EBS volumes, low-utilization compute, and unassociated Elastic IPs.
compliance_audit_export.csv: Full resource inventory with showback cost tags and compliance control mappings (SOC2 CC6.6, ISO27001 A.10.1.1).remediate_anomalies.sh: Ready-to-review bash script with safe CLI commands to purge waste.
2. Enterprise & Agency Quickstart (Multi-Account AWS Organizations)
Included in the Consultancy & Agency Pack (
enterprise_audit.py)
Scan multiple member accounts across an entire AWS Organization via STS role assumption and generate executive PDF reports.
Cross-Account IAM Role Setup
Deploy org-access-role.yaml via AWS CloudFormation StackSets across your target member accounts:
- Default Role Name:
OrganizationAccountAccessRole - Trust Relationship: Your primary management/auditing account ID.
Run Full Multi-Account Audit & Executive PDF Generation
python enterprise_audit.py --license-key YOUR_GUMROAD_KEY --report --remediate
Advanced Enterprise CLI Flags
| Flag | Description | Default |
|---|---|---|
--license-key |
Gumroad enterprise license key for verification | Required |
--report |
Compiles client-ready executive PDF report | False |
--report-out |
Custom output file path for the PDF deliverable | AWS_FinOps_Executive_Report.pdf |
--remediate |
Generates remediate_anomalies.sh purge script |
False |
--org-id |
Custom company/client name for PDF header branding | AWS Organization Root |
--regions |
Comma-separated list of AWS regions to scan | us-east-1,us-east-2,us-west-2 |
--role-name |
Cross-account IAM role to assume via STS | OrganizationAccountAccessRole |
--demo |
Populates report from sample_aws_data.csv if live accounts show $0 waste |
False |
Example: Multi-Region Scan with Custom Client Branding
python enterprise_audit.py \
--license-key YOUR_GUMROAD_KEY \
--org-id "Acme Corp Infrastructure" \
--regions "us-east-1,us-west-2,eu-west-1" \
--report \
--report-out "Acme_FinOps_Q4_Audit.pdf" \
--remediate
3. Executing Remediation Safely
Every audit that includes --remediate generates an idempotent bash script (remediate_anomalies.sh) with set -euo pipefail safety controls:
- Inspect before executing:
cat remediate_anomalies.sh # On Windows PowerShell: Get-Content remediate_anomalies.sh
- Execute remediation purge:
chmod +x remediate_anomalies.sh ./remediate_anomalies.sh
Non-destructive actions (like upgrading deprecated RDS engines) are prefixed with # as operational warnings and require manual review.
Support & Upgrades
- Commercial Licenses & Add-ons: Gumroad Product Portal
- Issues & Support: Contact support via your Gumroad receipt portal or primary vendor email.
Metadata
Release files for aws-finops-auditor 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aws_finops_auditor-1.0.0.tar.gz | 9.7 kB | Without provenance | Details for aws_finops_auditor-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aws_finops_auditor-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for aws_finops_auditor-1.0.0-py3-none-any.whl |
Total release size: 20.0 kB
Release files / aws_finops_auditor-1.0.0.tar.gz
| Download URL | aws_finops_auditor-1.0.0.tar.gz |
|---|---|
| Size | 9.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e9c66d4f488cf317abdae6cae3cf92c34dd5277dd6ca0f4f3553440cfe2a817f
|
|
BLAKE2b-256 checksum How to use checksums |
8bc9f89e217966cded8519f0d9b60451b4da069d57c521c1f4afeaaec093de2b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.11
|
Release files / aws_finops_auditor-1.0.0-py3-none-any.whl
| Download URL | aws_finops_auditor-1.0.0-py3-none-any.whl |
|---|---|
| Size | 10.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
964209f2f32d377727c7d192e24fdbab67f416b96e0e07f4d897e43bc22d8074
|
|
BLAKE2b-256 checksum How to use checksums |
6b47034b1b7294d01890e42c34e783f8131536f8af35d0afc20d60d7904cd8da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.11
|
Security for aws-finops-auditor 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.