git404hub

what is divvy fr?

danmat/divvy — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 2/5LicenseSetup · easy

tl;dr

A backtesting tool that replays your real investing history into a different portfolio to show the dividends and returns you would have earned instead.

vibe map

mindmap
  root((Divvy))
    What it does
      Replays real contribution history
      Compares dividend baskets
      Reinvests dividends DRIP
    Tech stack
      Python
      CLI
      Local web app
    Use cases
      Compare dividend ETFs
      Import Fidelity ledger
      Track dividend income growth
    Audience
      Dividend investors
      Personal finance tinkerers
    Data
      CSV contributions
      Fidelity 1099 import

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Backtest a real contribution history against a different set of dividend ETFs or stocks

VIBE 2

Compare multiple candidate portfolios side by side using a YAML bucket file

VIBE 3

Import a real Fidelity account export to auto-derive your true contribution calendar

VIBE 4

Track trailing twelve month dividend income growth with charts

what's the stack?

PythonCLIStreamlitYAML

how it stacks up fr

danmat/divvy0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Real personal data stays local, the public demo only uses synthetic sample data.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Divvy is a command line tool and web app for people who invest in dividend stocks and ETFs. It answers a specific question: if you had put the exact money you actually invested, on the exact dates you actually invested it, into a different portfolio, how much would you have earned in dividends and total return instead. Most backtesting tools online assume a clean, made-up contribution schedule like a fixed amount every month. Divvy is built around the idea that real investing is messy, since people skip months, add lump sums, or rebalance, so it replays your true contribution history rather than a synthetic one. You can define one or more candidate portfolios, called buckets, either inline on the command line or in a YAML file listing tickers and target weights. Divvy compares these buckets side by side, showing total money contributed, total dividends received with reinvestment, the trailing twelve month dividend income, ending portfolio value, total return, and a money-weighted return called XIRR that accounts for when contributions happened. Every comparison also includes a benchmark, SPY by default, and a chart showing dividend income growth over time, not just a single lifetime number. Contributions can come from a simple two-column CSV of dates and amounts, or Divvy can read real Fidelity account export files to work out your actual contribution calendar and actual dividends received automatically. There is also an optional feature to pull dividend income out of a Fidelity 1099 tax document, though that alone cannot drive a backtest since it does not show what you actually bought. For people who prefer a visual tool over the command line, there is an interactive local web app where you can add and remove tickers, drag weight sliders, and watch the comparison table and charts update. It runs entirely on your own machine, so your financial data never has to leave your computer, and there is also a public demo running on made-up sample data. Divvy is written in Python, installable through pip, and released under the MIT license, which allows free use, including commercial use, as long as the copyright notice is kept.

prompts (copy fr)

prompt 1
Help me set up a Divvy bucket YAML file comparing SCHD, VYM, and SDY
prompt 2
Show me how to import my Fidelity transaction history into Divvy
prompt 3
Explain what XIRR means in Divvy's comparison output
prompt 4
Walk me through launching the Divvy Experiment Lab web app locally

Frequently asked questions

what is divvy fr?

A backtesting tool that replays your real investing history into a different portfolio to show the dividends and returns you would have earned instead.

What language is divvy written in?

Mainly Python. The stack also includes Python, CLI, Streamlit.

What license does divvy use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is divvy to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is divvy for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.