# 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.

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.