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

![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)
[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-3776AB?logo=python&logoColor=white)](pyproject.toml)
[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/AojdevStudio/Finance-Guru?style=flat)](https://github.com/AojdevStudio/Finance-Guru/stargazers)

[**Quick Start**](#quick-start) · [**How it works**](#how-it-works) · [**Docs**](https://aojdevstudio.github.io/Finance-Guru/) · [**For agents**](#if-you-are-an-agent)

View full repository on GitHub →