greenkube/greenkube repository overview

⁠GreenKube — FinGreenOps Platform for Kubernetes

Measure, understand, and reduce the carbon footprint of your Kubernetes infrastructure.

GreenKube gives DevOps, SRE, and FinOps teams real-time carbon visibility and cost control over their Kubernetes workloads — in a single helm install.

⁠🚀 Try it in 30 seconds (no Kubernetes required)

docker run --rm -p 9000:9000 greenkube/greenkube:latest demo --no-browser --port 9000
# → Open http://localhost:9000

Loads 7 days of realistic data: 22 pods, 5 namespaces, carbon emissions, costs, and 40+ optimization recommendations.

Live demo: demo.greenkube.cloud⁠

⁠✨ What GreenKube gives you

• Per-pod CO₂e emissions — energy estimation based on SPECpower benchmarks and real-time grid intensity (Electricity Maps API)
• Cost tracking — via OpenCost integration (AWS, GCP, Azure, OVH, Scaleway, on-prem)
• Built-in web dashboard — SvelteKit SPA with ECharts, real-time charts, pod table, node inventory
• 9 types of recommendations — zombie pods, CPU/memory rightsizing, autoscaling, off-peak scheduling, carbon-aware scheduling, and more
• Grafana integration — pre-built dashboard + Prometheus metrics at /prometheus/metrics
• REST API — full FastAPI backend with OpenAPI docs at /api/v1/docs
• Flexible storage — PostgreSQL (default), SQLite (dev/demo), Elasticsearch (scale)

⁠📦 Production Deployment (Helm)

helm repo add greenkube https://GreenKubeCloud.github.io/GreenKube
helm repo update
helm install greenkube greenkube/greenkube \
  -n greenkube \
  --create-namespace

Access the dashboard:

kubectl port-forward svc/greenkube-api 8000:8000 -n greenkube
# → Open http://localhost:8000

⁠🎮 Demo mode (with kubectl)

kubectl run greenkube-demo \
  --image=greenkube/greenkube:latest \
  --restart=Never \
  --command -- greenkube demo --no-browser --port 9000

kubectl wait --for=condition=Ready pod/greenkube-demo --timeout=60s
kubectl port-forward pod/greenkube-demo 9000:9000
# → Open http://localhost:9000

kubectl delete pod greenkube-demo  # clean up when done

⁠🏗️ Architecture

GreenKube follows a clean hexagonal architecture:

• Collectors — Prometheus, Kubernetes API, OpenCost, Electricity Maps, Boavizta
• Core — energy estimation, CO₂e calculation, recommendation engine
• Storage — PostgreSQL / SQLite / Elasticsearch (Repository pattern)
• API — FastAPI + SvelteKit dashboard
• CLI — Typer-based, supports start, report, recommend, demo

⁠⚙️ Environment Variables

⁠🔗 Links

• GitHub: GreenKubeCloud/GreenKube⁠
• Documentation: greenkube.cloud⁠
• Live Demo: demo.greenkube.cloud⁠
• Helm Chart: GreenKubeCloud.github.io/GreenKube⁠
• Issues / Feature Requests: GitHub Issues⁠

⁠📄 License

Apache 2.0 — free for personal and commercial use.