Skip to main content

Genealogical tools

Project description


alt text alt text alt text alt text

Several genealogical python tools included which are under development.

It is mainly offering the following capabilities:

  1. Access by command line to Geni profiles and relationship information.
  2. Geni interface
  • Build a tree of ancestors in Geni
  • Build a map of cousins of a given profile in Geni.
  • Create a child, parents or partner in geni
  • Delete a profile in geni
  • Get profile, relations and union data.
  • Extract the tree of descendants of a profile in gedcom
  1. Several genealogical functions.
  • Get children surname based on several naming conventions
  • Get name removing surnames
  • Check dates consistency in profiles
  • Guess the names and surnames from a complete surname (beta)
  1. A common base profile for any genealogical input
  • Merging profile algorithm (basic)
  1. A tool for parsing FamilySearch excel outputs of sons in a family.
  • Import to Geni an excel output of children from FamilySearch records, it will merge common profiles
  1. Interface with several online registers:
  1. GEDCOM file wrapper
  • It allows to read gedcomfiles and operated them (add new profiles)
  • It allows to transform data from other sources (Geni, RootsMagic) into GEDCOM.
  1. Automatic investigation
  • For those interfaces avaialble, it can found potential matches in a GEDCOM.
  1. RootsMagic interface
  • It provide a simple interface to RootsMagic database allowing to access the data and the different profiles.
  1. Matching and synchronization between different genealogical databases
  • It identifies profiles existing in 2 databases (i.e. RootsMagic and Geni) and synchronizes, by creating missing profiles
  1. Perform some quality checks of wrong or missing data

Notice that this import is intended to import registers from FamilySearch, is you are interested in importing profiles from a family tree located in FamilySearch to Geni use this tool:, which is a pretty nice piece of software and very helpful.

This application uses the Geni API but is not endorsed, operated, or sponsored by

Installation instructions

You can install it using pip

pip install pyGenealogicalTools

Tested using python 3.5.3 and 3.6.2, happy to test other versions if needed. Main limitation are the testing capabilities in travis for wxpython.

In order to use the tools you will need to install the following modules:

All the previous modules are available in the requirements.txt file, but wxpython needs to be manually installed, visit wxpython page for further info.

Concerning testing, the repository if configured to use nose, coverage, nose-htmloutput, so you will need to install in your local installation as well.

Geni KEY

In order to use the interface, you will need to generate an application card inside Geni and obtain a key. You can create the application card in this: location, the key will be only valid for 24h, so you will need to register again the key regularly.

For each execution of the Geni API contained in this software, you will later need to introduce the key. Do not make the key public. In the examples area you have a description of how to obtain the key in execute the complete module, in a nutshell this is the way to set the Geni Key:

from pyGeni import set_token
GENI_KEY = "IntroduceHereYourGeniKey"

MapBox API Key

As google Maps API is no longer working without payments details, Google API has been replaced by MapBox API. In order to work the library needs the MAPBOX API (free of charge). Just set-up this way:

from pyGenealogy import set_mapbox_key
MAPBOX_KEY = "IntroduceHereYourMapBoxKey"


The file GeniTools is the one I am using as main programme. It is not yet very stable, but the libraries are getting. Just use the input file "INPUT_TEMPLATE" and select as input inside the script, the input file needs to include the Geni token and the starting profile.

In order to get the token just go here: and introduce it in the input file as GENIKEY. Notice that the key gets updated almost everyday... so everytime you are using this script you will need to do it.

Interested in helping?

There are several areas where you can collaborate:

  • Report any wrong behaviour as an issue
  • Comment the code where it is not properly commented
  • Provide naming and surname conventions for other languages
  • Support on documentation development or examples
  • Solve an specific issue

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

pyGenealogicalTools-1.0.2.tar.gz (108.2 kB view hashes)

Uploaded source

Built Distribution

pyGenealogicalTools-1.0.2-py3-none-any.whl (172.5 kB view hashes)

Uploaded py3

Supported by

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