Skip to main content

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 configure or 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:

  1. Inspect before executing:
    cat remediate_anomalies.sh
    # On Windows PowerShell:
    Get-Content remediate_anomalies.sh
    
  2. 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)

Source distribution for aws-finops-auditor 1.0.0
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)

Table of built distributions (wheels) for aws-finops-auditor 1.0.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page