v0.2.0 — file-less quickstart

Added

• Inline --holdings for divvy compare — define a bucket without a YAML file, e.g. --holdings "SCHD=45,DGRO=25,VYM=15,SDY=15" (weights auto-normalized, repeatable). The quickstart now runs from any directory with zero files.

Fixed

• The documented quickstart previously referenced repo-only example bucket files, which failed for pip install-ed users. The file-less --holdings path fixes this.

pip install divvy-backtest
divvy compare --synthetic-monthly 500 --synthetic-start 2019-01-01 \
  --holdings "SCHD=45,DGRO=25,VYM=15,SDY=15" \
  --holdings "SCHD=40,VYM=20,SDY=20,SPYD=20"

v0.1.0 — Divvy

First public release of Divvy — replay your real investing history against a different portfolio and compare the dividends & returns you'd have earned.

Highlights

• Real-ledger replay — feed your actual contribution calendar (Fidelity ledger export, a generic date,amount CSV, synthetic DCA, or a Fidelity 1099 dividend importer) into any basket of ETFs/stocks, with dividend reinvestment (DRIP).
• Dividends as a first-class metric — lifetime + trailing-12-month run-rate, alongside total return and money-weighted XIRR.
• Meaningful comparison — automatic SPY benchmark row, risk metrics (max drawdown, volatility), and a dividend-income-by-year chart.
• Realism knobs — optional after-tax dividends, periodic rebalancing, and expense-ratio drag.
• Interactive Experiment Lab — a local Streamlit app to add/remove tickers, tweak weights, and compare live.
• Forward projection — how much to invest monthly to reach an income goal, with a Monte Carlo range.
• Private by default — all financial data stays on your machine.

Install

pip install divvy-backtest          # core CLI (import + command are 'divvy')
pip install 'divvy-backtest[ui]'    # + interactive Experiment Lab

Divvy is an analysis tool, not investment advice. Backtests describe the past; past performance does not predict the future.