AojdevStudio/Finance-Guru

README preview

<div align="center">

<img src="docs/images/finance-guru-logo.png" alt="Finance Guru monogram" width="96">

# Finance Guru

### **Your brokerage account is not a spreadsheet problem. It is an operating system problem.**

_A self-hosted family office engine: typed Python calculators, a private SQLite ledger, and specialist agents that run inside Claude Code or Codex. Your data never leaves your machine unless you point it somewhere._

<!--
TODO: Replace docs/images/demo-risk-metrics.gif with a 20-30s demo clip.
The clip should show Claude Code asking whether a position is too big, a calculator running, and a guardrail blocking.
Keep this GIF until that clip exists.
-->

![Terminal recording of the risk metrics CLI printing VaR, CVaR, Sharpe, Sortino, drawdown, volatility, beta, and alpha for TSLA against SPY](docs/images/demo-risk-metrics.gif)

[![CI](https://github.com/AojdevStudio/Finance-Guru/actions/workflows/ci.yml/badge.svg)](https://github.com/AojdevStudio/Finance-Guru/actions/workflows/ci.yml)
[![Quality gates](https://github.com/AojdevStudio/Finance-Guru/actions/workflows/quality-gates.yml/badge.svg)](https://github.com/AojdevStudio/Finance-Guru/actions/workflows/quality-gates.yml)

View full repository on GitHub →