# FinData OS

Private, research-grade financial data lakehouse for the MacLustr cluster — https://findata.spboucher.ai (owner only).

- Vendor: **FirstRate Data** (market data bundles + US fundamentals API). License: private use, no redistribution.
- Node: M3U96a (1 TB NVMe), lake `~/findata-lake`, PostgreSQL 17 metadata, DuckDB reads, FastAPI `/api/v1`, Next.js console.
- Docs: `docs/DISCOVERY.md` (phase 0 evidence), `docs/ARCHITECTURE.md`, `docs/DATA_DICTIONARY.md`, `docs/OPERATIONS.md`, `docs/SECURITY.md`, `docs/STATUS.md`.

```bash
uv sync && make test                 # 36 tests (unit + integration against local Postgres `findata_test`)
make web                             # build the console (apps/web/out)
uv run findata --help                # operator CLI
```
Python SDK: `packages/python-sdk` — `from findata_sdk import FinData`.