Finops-scan: Free CLI to scan AWS Cost Explorer for waste (open source, Python)

kamsteph2 pts0 comments

GitHub - kamsteph/finops-scan: Scan your AWS account for cloud waste in 60 seconds · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

kamsteph

finops-scan

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>3 Commits<br>3 Commits

.idea

.idea

src/finops_scan

src/finops_scan

tests

tests

.gitignore

.gitignore

README.md

README.md

pyproject.toml

pyproject.toml

View all files

Repository files navigation

finops-scan

Scan your AWS account for cloud waste in 60 seconds.

Free, open source, read-only. No data stored. No resources modified.

pip install finops-scan<br>finops-scan --access-key AKIA... --secret-key ...

What it does

finops-scan connects to your AWS Cost Explorer API (read-only) and produces a ranked waste report in your terminal:

Top services by spend — with 30-day trend (increasing/decreasing/stable)

Waste opportunities — ranked by estimated impact, with specific actions

Tag coverage score — what % of your spend has team attribution

Estimated savings — conservative 20% estimate of actionable waste

Required IAM permission

finops-scan only needs one permission:

"Version": "2012-10-17",<br>"Statement": [<br>"Effect": "Allow",<br>"Action": [<br>"ce:GetCostAndUsage"<br>],<br>"Resource": "*"

Create a read-only IAM user with this policy and pass the credentials to finops-scan.

Installation

pip install finops-scan

Usage

# Using flags<br>finops-scan \<br>--access-key YOUR_ACCESS_KEY \<br>--secret-key YOUR_SECRET_KEY \<br>--region us-east-1 \<br>--account-id my-company

# Using environment variables (recommended)<br>export AWS_ACCESS_KEY_ID=YOUR_ACCESS_KEY<br>export AWS_SECRET_ACCESS_KEY=YOUR_SECRET_KEY<br>finops-scan

What it does NOT do

Does not store any data

Does not modify any AWS resources

Does not require CUR or S3 setup

Does not need root AWS credentials

Does not send data anywhere except your terminal

Built by fynC

finops-scan is the free CLI companion to<br>fynC — a FinOps platform for cloud<br>and AI spend visibility.

fynC monitors your spend continuously, alerts you on anomalies,<br>attributes costs to teams automatically, and tracks AI/LLM spend<br>at the model level alongside cloud infrastructure costs.

Join the early access list →

License

MIT

About

Scan your AWS account for cloud waste in 60 seconds

Resources

Readme

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

star

Watchers

watching

Forks

forks

Report repository

Releases

No releases published

Packages

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

Python<br>100.0%

You can’t perform that action at this time.

scan finops waste reload cloud search

Related Articles