coulomb/fin-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Resource viability hub for budgets, commitments, burn rate, runway projection, and token spend tracking.
3 commits 1 branch 0 tags 769 KiB
Find a file
tegwick 883f425ef8 Add Forgejo CI smoke workflow (enablement template)
2026-07-08 12:43:08 +02:00
.forgejo/workflows Add Forgejo CI smoke workflow (enablement template) 2026-07-08 12:43:08 +02:00
docs Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
src/fin_hub Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
tests Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
.gitignore Bootstrap fin-hub scaffold from hub-core (CUST-WP-0025-T22/T23) 2026-07-08 00:50:24 +02:00
CLAUDE.custodian.md Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
INTENT.md Bootstrap fin-hub scaffold from hub-core (CUST-WP-0025-T22/T23) 2026-07-08 00:50:24 +02:00
pyproject.toml Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
README.md Implement fin-hub T24-T26: ingest, runway, coupling, RaaS packaging 2026-07-08 00:59:39 +02:00
SCOPE.md Bootstrap fin-hub scaffold from hub-core (CUST-WP-0025-T22/T23) 2026-07-08 00:50:24 +02:00
uv.lock Bootstrap fin-hub scaffold from hub-core (CUST-WP-0025-T22/T23) 2026-07-08 00:50:24 +02:00

README.md

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

cd /home/worsch/fin-hub
uv sync
uv run pytest
uv run finhub runway --balance 12000 --monthly-burn 2100,2200,2000
uv run finhub import-cloud tests/fixtures/cloud-costs.csv
uv run finhub ops-costs tests/fixtures/hosteurope.csv

Cross-hub coupling (--emit) posts non-secret progress events to dev-hub when STATE_HUB_API is reachable.

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