k8s-pod-foamtree

k8sfoams is a local, read-only dashboard that answers one question: where is my cluster's requested CPU and memory actually going, and how much room is left on each node?

It visualizes resource requests — what the scheduler reserves — not live usage. That makes it a tool for spotting over-requesting pods and idle headroom, not a performance monitor. It runs on your laptop, reads ~/.kube/config (or $KUBECONFIG) with the standard Kubernetes client, and needs no in-cluster deployment and no metrics-server.

Documentation · Live demo — the real dashboard on synthetic clusters, in your browser.

A one-minute tour on the synthetic demo clusters — run it yourself with k8sfoams --synthetic.

Features

• 2D map and 3D cubes of every node and pod, sized by requests.
• Node health: free capacity on cordoned, NotReady, pressured or tainted nodes is hatched, because it is not really free.
• Topology: group nodes by zone, region, node pool, instance type or spot / on-demand.
• Audit & hygiene: missing requests or limits, monoliths, naked pods, single replicas, replicas sharing one node, zone or spot pool.
• QoS & eviction risk: color pods by QoS class.
• Scheduling simulators: "Can I fit this pod?", "What happens if I drain this node?", "Which nodes could be removed?", "Can I scale this workload by N replicas?" and "Do the pending pods fit?", with hypothetical nodes to try node shapes before you add them.
• Filtering: a query bar that highlights matching pods by namespace, label, QoS, node, topology or finding.
• Extended resources: GPUs, ephemeral storage and HugePages, with fragmentation and stranded devices.
• Export to PNG, SVG, JSON or CSV, and shareable links to any view.
• Live updates from a watch cache, so scaling a Deployment shows up within seconds.

Installation

pip install k8sfoams
# or with uv
uv pip install k8sfoams

To install from source, see Getting started.

Run

k8sfoams              # your kubeconfig contexts, at http://127.0.0.1:8080
k8sfoams --synthetic  # no cluster needed: generated demo clusters that keep changing

Switching context in the dashboard never modifies your kubeconfig. See the command-line reference for every option and Synthetic mode for what the demo clusters contain.

Development

make restore_dev     # install with dev dependencies
make run-synthetic   # build the UI and run on the synthetic clusters
make tests           # type checking, linting, security, unit tests
make docs-serve      # the docs site with live reload

See Development for the frontend build, the docs and the CI targets.