Welcome to narevai/narev

We donate a portion of our development time to an open-source package that unifies cloud billing data into FOCUS format defined by FinOps Foundation. We do it because we want to accelerate the adoption of the FOCUS reporting across the Cloud and AI providers.

What is `narevai/narev`?

This project allows you to connect with cloud, AI and SaaS vendors and unify your billing data. It helps with:

Extracting Cloud, AI and and SaaS costs
Exporting costs in a FOCUS format
Providing a dashboard visualizing the spending by type

Getting Started

Demo Mode

If you wnat to explore the functionality with sample data, start with a demo mode:

docker run -d \
  --name narev-billing-demo \
  -p 8000:8000 \
  -v $(pwd)/data:/app/data \
  -e DEMO="true" \
  ghcr.io/narevai/narev:latest

narevai/narev will be running at: http://localhost:8000

Demo mode includes:

Sample billing data from AWS, Azure, and GCP
Realistic usage patterns and cost data
Pipeline run history
No encryption key needed! Demo mode automatically generates one for you.

Production Setup

For production, you will need to generate your own encryption key:

1. Generate the encryption key

python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

2. Run the container with the generated key:

docker run -d \
  --name narev-billing \
  -p 8000:8000 \
  -v $(pwd)/data:/app/data \
  -e ENCRYPTION_KEY="gAAAAABhZ_your_actual_generated_key_here" \
  -e ENVIRONMENT="production" \
  ghcr.io/narevai/narev:latest

3. Connect your providers

Now that the Docker is running, add your cloud providers: Connect providers Guide

4. Import billing data

Sync your historical cost data: Sync providers Guide

5. Advanced Deployment

For production environments see advanced configuration: Deployment Guide

Need Help?

Get community support and ask questions: GitHub Discussions

Billing Getting Started