Skip to content

daretechie/cloudcull

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

48 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CloudCull Logo

CloudCull: The Autonomous Multi-Cloud GPU Sniper

Live Demo CloudCull Autonomous Audit License: MIT

CloudCull is an "Investor-Grade" autonomous governance framework designed to detect and eliminate GPU waste across AWS, Azure, and Google Cloud Platform. By 2026, it is the standard for multi-cloud cost optimization.

πŸ”΄ VIEW LIVE DEMO DASHBOARD

Python 3.12 AWS FinOps GCP FinOps Azure FinOps


πŸ’° The 2026 Problem: "GPU Bankruptcy"

Startups and AI companies lose thousands of dollars every month because expensive GPU instances are left running idle. Manual tagging and spreadsheets are not enough to stop this bleeding.

πŸ”« The Solution: CloudCull

CloudCull is not a dashboard; it is an Execution-First Sniper Agent. It proactively scans your multi-cloud environment, uses Multi-Model Intelligence (Claude/Gemini/Llama) to classify instance state, and provides a Kill-Switch to stop waste immediately.


πŸ›οΈ Architecture: "The Sniper Pattern"

CloudCull follows a robust, CLI-first automation flow designed for deep integration into DevOps pipelines.

graph LR
    Trigger["Cron / GitHub Action"] --> Probe["Probe: Multi-Cloud SDKs"]
    Probe --> Analyzer["Analyzer: Multi-Model AI"]
    Analyzer -- "Decision: Zombie Identified" --> UI["UI: Approval Notification"]
    UI -- "Approve" --> Stop["Stop: Cloud Native API"]
    Stop --> StateRM["State RM: Terraform"]
Loading

πŸ—οΈ Key Features

  • οΏ½ High-Fidelity Brain: Pluggable AI (Claude 3.5, Gemini 1.5, Llama 3) for intelligent classification.
  • πŸ“‘ Sniper Console: A technical Vite + React dashboard with AI Reasoning Callouts, Live Terminal Logs, and One-Tap Kill Actions.
  • πŸ‘€ Identity Layer: Finds exactly who launched the instance for high-stakes accountability.
  • πŸ› οΈ IaC-Driven Remediation: Generates terraform state rm plans instead of raw, risky deletions.

πŸ› οΈ Usage

Note

CloudCull is a CLI-First Tool. The dashboard is a passive visualization layer.

1. Installation (via uv)

git clone https://github.com/daretechie/cloudcull.git
cd cloudcull
uv sync

Alternative (Standard pip):

pip install -r requirements.txt

2. Run a Demonstration (Full Walkthrough)

This script simulates a multi-cloud audit and remediation flow with high-fidelity logs.

./scripts/demo.sh

3. Execution (ActiveOps)

To run a real-world audit and trigger the automated remediation bundle:

uv run cloudcull --region us-east-1 --active-ops # AWS
uv run cloudcull --platform azure --active-ops # Azure
uv run cloudcull --platform gcp --active-ops   # GCP

Caution

--active-ops will perform cloud-native stop actions and generate config/remediation_manifest.json. Use with high-stakes environments after dry-run verification.


πŸ’Ό Commercial Support & Audits

Don't have time to run the Sniper yourself? I provide professional, fixed-price audits and CI/CD integration services.

Hire on Upwork

  • One-Time Audit: Rapid detection of multi-cloud waste.
  • Governance Setup: Deliverable Remediation manifests and fixes.
  • Continuous Ops: Full CI/CD integration for automated cost control.

πŸ“‚ Repository Orientation

Directory Purpose
src/ Source Code. All Python modules, adapters, and the main entrypoint.
infra/ Infrastructure. Dockerfile, Docker Compose, and future IaC (Terraform).
config/ Configuration. Static and dynamic manifests (e.g., remediation plans).
scripts/ Tooling. Utility scripts and demonstration walkers.
docs/ Documentation. Architecture, Operations, and Security guides.
tests/ Validation. Unit and integration test suites.
dashboard/ Visualization. React + Vite frontend for Passive Monitoring.

🐳 Deployment & Docker

CloudCull is container-ready for consistent execution.

Running with Docker

# Build & Run
docker build -f infra/Dockerfile -t cloudcull .
docker run --env-file .env cloudcull --simulated --dry-run

Running with Docker Compose

docker-compose up

🌐 Dashboard (GitHub Pages)

To enable the live dashboard, you must manually activate GitHub Pages in your repository settings:

  1. Go to Settings > Pages.
  2. Under Build and deployment > Source, select GitHub Actions.

πŸ“„ Documentation

πŸ” Security Checks

To run security audits against the codebase (excluding virtual environments):

uv run bandit -c pyproject.toml -r .

πŸ“„ License

This project is licensed under the MIT License.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published