# Setup guide — ROI Scenario Analysis Agent

## 1. Install and configure

Install the agent and set your model defaults.

```
pipx install roi-scenario-agent
roi-scenario-agent init --currency USD
roi-scenario-agent doctor
```

## 2. Configure guardrails

No fabricated data and estimate-labeling are enforced here.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
NO_FABRICATED_DATA=true
ALWAYS_INCLUDE_DOWNSIDE=true
LABEL_AS_ESTIMATE=true
```

## 3. Define the model

Declare inputs and which metrics to compute.

```
# model.yml
inputs: [initial_cost, annual_cashflow, years, discount_rate]
metrics: [roi_pct, npv, payback]
scenarios: [downside, base, upside]
```

## 4. Run an analysis

Model a scenario and review assumptions and ranges.

```
roi-scenario-agent run --inputs ./inputs.json --explain
# prints results + formulas + scenarios + sensitivity (TBD for missing inputs)
```

## 5. Wire into planning

Generate transparent models for review and decisions.

```
# inputs/assumptions -> ROI model with ranges -> human reviews and decides
```
