> ## Documentation Index
> Fetch the complete documentation index at: https://www.narev.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Open source FOCUS translator

> Deploy the open source Varne translator to unify cloud and AI provider billing data into the FOCUS specification for FinOps reporting.

> [!NOTE]
>
> This page documents **Varne v0**. **Varne v1 is in development**. These instructions apply to v0, not the developing v1 branch.

> [!TIP]
>
> The team donates a portion of development time to an open source package that unifies cloud billing data into FOCUS
> format defined by the [FinOps Foundation](https://focus.finops.org/). This work helps accelerate the adoption
> of the FOCUS reporting across the Cloud and AI providers.

## What's `narevai/varne`?

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

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

***

## Getting started

### Demo mode

If you want to explore the feature set with sample data, start with demo mode:

```bash theme={null}
docker run -d \
  --name varne-demo \
  -p 8000:8000 \
  -v $(pwd)/data:/app/data \
  -e DEMO="true" \
  ghcr.io/narevai/varne:0.5.0
```

`narevai/varne` runs 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

```bash theme={null}
python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
```

#### 2. Run the container with the generated key:

```bash theme={null}
docker run -d \
  --name varne \
  -p 8000:8000 \
  -v $(pwd)/data:/app/data \
  -e ENCRYPTION_KEY="gAAAAABhZ_your_actual_generated_key_here" \
  -e ENVIRONMENT="production" \
  ghcr.io/narevai/varne:0.5.0
```

#### 3. Connect your providers

Now that the Docker is running, add your cloud providers:
**[Connect providers Guide](https://www.narev.ai/docs/varne/v0/connect-providers.md)**

#### 4. Import billing data

Sync your historical cost data:
**[Sync providers Guide](https://www.narev.ai/docs/varne/v0/getting-started/sync-providers.md)**

#### 5. Advanced Deployment

For production environments see advanced configuration: [Deployment Guide](https://www.narev.ai/docs/varne/v0/getting-started/deployment.md)

## Need Help?

Get community support and ask questions:
**[GitHub Discussions](https://github.com/narevai/varne/discussions)**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.