Skip to main content

Store family trees in plain text and visualize them in your browser

Project description

pedigree takes a [toml][] file like that in examples/example.toml ([source][]) and outputs a few messy visualizations that do not favor patriliny over matriliny. See examples/ for example output.

![Screenshot 1](media/screenshot1.png) ![Screenshot 2](media/screenshot2.png)


For a quick example, generate the example .toml file

pedigree -f new_relations.toml

then generate output based on it

pedigree -f new_relations.toml generate


  • .html file: a [d3][] visualization that can be opened in a web browser

  • .svg file: a “Sugiyama style” tree that can be opened in a web browser

  • .dot file: the [dot][] file used to generate the .svg file


pip3 install pedigree

pedigree –help will tell you your options.

You need to install graphviz form your package manager if you want to generate .svg output


Please create an [issue]( for any bugs you find.

If you’re a developer, the bugs are actually being kept in [git-bug](, so feel free to work with them there.


  • Don’t put all your genealogical data in one text file that you manipulate via a python script written by some idiot on the internet. At least make copies of the one text file.

  • This can only recognize the relations x is the mother of y, x is the father of y, and x is the spouse of y. It has no concept of siblings or partial siblings.

[toml]: [d3]: [dot]: [source]:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pedigree-1.1.0.tar.gz (16.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page