# Fin Hub

Resource viability hub for the FOS federation — budgets, commitments, burn rate,
runway projection, and token spend tracking.

Fin-hub extends `hub-core` with financial models and read surfaces. Generic hub
primitives (domains, repos, messages, progress events) come from hub-core;
fin-specific models (budget, commitment, burn rate, runway, token spend) live
here.

## Status

Bootstrap scaffold (`CUST-WP-0025-T22`). Models and ingestion pipelines are
tracked in `CUST-WP-0025-T23`–`T24`.

## Quick Start

```bash
cd /home/worsch/fin-hub
uv sync
uv run pytest
```

## Related Workplans

- `the-custodian/workplans/CUST-WP-0025-fos-hub-bootstrap.md` — umbrella
- `canon/constitution/bootstrap-protocol_v0.1.md` — funding and roles
- `canon/projects/railiance/business-model-canvas_v0.1.md` — monetization path