> ecos-labs.io

Issues · Contribution

---

• What is ecos?
• What's included?
• Quickstart
• Contributing

What is ecos?

ecos is an open source FinOps data stack that transforms AWS Cost and Usage Reports (CUR) into clean, enriched, high-performance datasets. Its analytics-ready semantic layer enables cost transparency, allocation, and optimization with actionable insights.

Highlights:

• Own Your Data - Runs in your infrastructure, any cloud or warehouse. Full transform transparency, data never leaves your account.

• Modular & Extensible - 40+ pre-built data models. Start small, extend with your business logic and data, sources unified automatically.

• Production Ready - Smart data materialization balances speed and cost. Fast CLI deployment, serverless scaling, full dbt extensibility.

• Advanced Analytics - Semantic layer for BI and AI agents. Pinpoint cost drivers, expose savings potentials, track trends and more.

AWS Cost and Usage Reports (CUR) with Athena, today. All clouds, eventually.

What's included?

• ecos CLI - One-command project setup, provisioning, and model deployment
• dbt Models - 40+ pre-built SQL models for cost analysis and optimization
  • Bronze - Views: raw CUR data from S3
  • Silver - Views/incremental tables: cleaned, normalized, mapped data
  • Gold - Incremental Tables (partitioned): business-ready analytics (pre-computed, fast queries)
  • Serve - Custom views you create based on your needs
• Web UI - Interactive lineage graph and data catalog browser
• MCP Server - (Preview) AI-powered cost insights via Model Context Protocol

Quickstart

For detailed setup view the full Quickstart guide.

1. Enable AWS CUR Setup AWS Cost & Usage Reports for Athena.

2. Install ecos CLI

# Install via brew
brew tap ecos-labs/homebrew-ecos
brew install ecos

# Verify installation
ecos version

3. Initialize Project

mkdir ecos-playground && cd ecos-playground
ecos init

4. Transform Your Data

# Load reference data
ecos transform seed

# Run all transformations
ecos transform run

5. Query & Analyze

-- Daily service costs
select
  usage_date,
  service_name,
  sum(total_effective_cost) as cost
from gold_core__service_daily
where billing_period = '2025-10'
group by 1, 2
order by 3 desc;

Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, improving documentation, or helping others. Your contributions are greatly appreciated.

• Issues - Report features or bugs
• Contributing Guide - Learn how to contribute
• Code of Conduct - Our community standards

---

_{Built with ❤️ by ecos-labs.io}