# AtlasBurn

> AI Capital Risk Engine — forensic burn modeling and stochastic survival forecasting for AI workloads.

AtlasBurn is an SDK and platform for tracking, controlling, and optimizing AI API costs in real time. It provides deterministic capital protection via the Auto Kill protocol, forensic-grade audit trails, and Monte Carlo burn forecasting.

## Core Capabilities

- **Forensic Ledger**: Immutable, append-only audit trail of every AI API call with token counts, cost estimates, and metadata.
- **Cost Engine**: Real-time cost estimation using PROVIDER_REGISTRY (exact pricing) and FALLBACK_ECONOMICS (safety fallback). 94.2% audited confidence against actual provider invoices.
- **Auto Kill Protocol**: Deterministic budget enforcement that halts spend when thresholds are breached. No soft warnings — hard capital protection.
- **Universal Auto-Detection**: Monkey-patches `globalThis.fetch` to intercept OpenAI, Anthropic, Gemini, and Meta API calls without code changes.
- **Monte Carlo Forecasting**: Stochastic burn rate projections at P50, P95, and P99 confidence intervals.

## Supported Providers

- OpenAI (Auto-Detect)
- Anthropic (Auto-Detect)
- Google Gemini (Auto-Detect)
- Meta (Manual Wrapper)

## Quick Start

```
npm i @atlasburn/sdk
```

```typescript
import { initAtlasBurnAuto } from "@atlasburn/sdk";
initAtlasBurnAuto({ apiKey: process.env.ATLASBURN_KEY });
```

## Links

- Docs: https://docs.atlasburn.com
- App: https://app.atlasburn.com
- Full LLM spec: https://atlasburn.com/llms-full.txt
- Contact: contact@atlasburn.com

## Docs

- [Getting Started](https://docs.atlasburn.com/getting-started)
- [Quickstart](https://docs.atlasburn.com/quickstart)
- [How It Works](https://docs.atlasburn.com/how-it-works)
- [SDK Reference](https://docs.atlasburn.com/sdk)
- [Integrations](https://docs.atlasburn.com/integrations)
- [Telemetry Architecture](https://docs.atlasburn.com/telemetry)
- [Cost Engine](https://docs.atlasburn.com/cost-engine)
- [Accuracy & Confidence](https://docs.atlasburn.com/accuracy)
- [Security](https://docs.atlasburn.com/security)
- [Troubleshooting](https://docs.atlasburn.com/troubleshooting)
- [Glossary](https://docs.atlasburn.com/glossary)
- [Advanced Concepts](https://docs.atlasburn.com/advanced)
- [Changelog](https://docs.atlasburn.com/changelog)