Skip to content
This repository has been archived by the owner on Oct 22, 2019. It is now read-only.


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation


A python package for working with the Current Population Survey.

Documentation is available at readthedocs.

Neither the Census Bureau nor the NBER provide a clean, RESTful API for getting CPS data. This makes working with the CPS a pain, and reproducibility nearly impossible.

What does it do?

There's a few related functions PyCPS provides:

  1. Downloading data dictionaries and monthly data files
  2. Standardizing variables across months
  3. Merging to create time series


  • From pip: pip install pycps

  • From source:

    git clone
    cd pycps
    pip install .
    pip install -r requirements.txt
    pip install git+
    python install


See requirements.txt


Developed with python 3, aims to be compatible with python 2.