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

# Flux: Governed Azure FinOps Intelligence Workspace

> Flux synchronizes Azure inventory, cost, and VM telemetry into a governed analytical workspace with explainable opportunities and a conversational AI.

Flux is a focused Azure FinOps intelligence platform. It pulls your Azure Resource Graph inventory, Cost Management data, Azure Advisor recommendations, and VM telemetry into a local DuckDB analytical store — then surfaces explainable, evidence-backed optimization opportunities through a modern React dashboard and a governed conversational AI assistant called **Ask Flux**.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="quickstart">
    Install Flux and connect it to your Azure subscriptions in minutes.
  </Card>

  <Card title="Configuration" icon="gear" href="configuration">
    Full reference for all FLUX\_ environment variables and tuning options.
  </Card>

  <Card title="Core Features" icon="layer-group" href="features/overview-dashboard">
    Explore the dashboard, inventory, cost anomalies, opportunities, and right-sizing.
  </Card>

  <Card title="Ask Flux (AI)" icon="robot" href="features/flux-intelligence">
    Governed conversational AI backed by 19 bounded, read-only tools.
  </Card>

  <Card title="Deployment" icon="cloud" href="deployment/azure-app-service">
    Deploy to Azure App Service with managed identity and Easy Auth.
  </Card>

  <Card title="API Reference" icon="code" href="api/overview">
    Browse every REST endpoint with parameters and response shapes.
  </Card>
</CardGroup>

## What Flux does

<Steps>
  <Step title="Synchronize your Azure estate">
    Flux connects to Azure Resource Graph, Azure Advisor, Cost Management, Azure Monitor, and LogicMonitor. A durable background worker collects inventory, costs, recommendations, and telemetry on independent schedules and stores everything as append-only snapshots in DuckDB.
  </Step>

  <Step title="Surface governed opportunities">
    The Flux Signals rule engine evaluates your inventory against versioned ARG rules. Azure Advisor findings are ingested, semantically de-duplicated, and combined with Flux Signals into a unified opportunity queue — each finding carrying evidence, confidence, and provenance-aware cost valuation.
  </Step>

  <Step title="Investigate with Ask Flux">
    Ask Flux answers FinOps questions across cost, anomalies, optimization, right-sizing, inventory, and governance. The AI model calls only 19 declared server-side tools — it has no direct database access, no Azure credential, and no ability to mutate your cloud estate.
  </Step>

  <Step title="Plan and act">
    Right-sizing planning boards let your team turn telemetry-backed candidates into reservation and savings-plan purchase decisions. Virtual tags let you classify cost without writing tags back to Azure.
  </Step>
</Steps>

## Key capabilities

<CardGroup cols={3}>
  <Card title="Inventory & Changes" icon="database" href="features/inventory">
    Searchable Azure Resource Graph inventory with consecutive-snapshot drift detection and median/MAD anomaly baselines.
  </Card>

  <Card title="Cost Management" icon="circle-dollar-to-slot" href="features/cost-management">
    Actual and amortized cost, FOCUS v1.0 charge ledger, seasonal anomaly detection, and 90-day cost history.
  </Card>

  <Card title="Opportunities" icon="lightbulb" href="features/opportunities">
    Unified Advisor + Flux Signals queue with evidence packs, confidence scoring, and CSV export.
  </Card>

  <Card title="Right-Sizing" icon="arrows-to-circle" href="features/rightsizing">
    Multi-source VM classification using Azure Monitor, LogicMonitor, and Advisor corroboration.
  </Card>

  <Card title="Virtual Tags" icon="tags" href="operations/virtual-tags">
    Governed cost allocation dimensions without writing native Azure tags.
  </Card>

  <Card title="API" icon="plug" href="api/overview">
    Full FastAPI REST surface at /api — interactive docs at /docs.
  </Card>
</CardGroup>