Dr. Junaid Farooq

Cost Narrative

Open-source investigation of cloud and AI cost spikes.

StatusActive, maintained
LicenceMIT
LanguagePython, TypeScript
Started2026
Codegithub.com/JunaidFarooqZargar/cost-narrative

Cost Narrative is an open-source workbench for engineering teams that need to explain a sudden rise in cloud or AI spending. It correlates billing anomalies with engineering events such as deploys, autoscaling, configuration changes and retry storms, and presents ranked hypotheses with confidence scores rather than a single answer.

It connects to AWS Cost Explorer, Azure Cost Management and OpenAI and Anthropic usage data, reads deploy events from GitHub and scaling events from Kubernetes, and runs self-hosted with Docker Compose so billing data stays on your own infrastructure.

Cost Narrative cost overview dashboard with spend totals and a daily cost chart
Cost overview: total spend, trend and the services driving it.
Cost Narrative anomalies view listing a detected cost spike
Anomalies: detected spikes, each opened as an investigation.
Cost Narrative settings page with cloud, AI provider and engineering-event integrations
Settings: connect cloud accounts, AI providers and engineering event sources.