jcp-data-manager 0.1.0

Utilities for merging session data with LinkedIn member exports and optional demographic enrichment.

jcp-data-manager

This folder now contains a package-friendly Python implementation of the workflow from merge_testing.ipynb. It is designed to work with arbitrary input files, not just the example JSON files in this repo, as long as they follow the same two source formats.

What it does

• Loads LinkedIn member JSON data
• Loads session JSON data
• Normalizes and merges both datasets on user_id
• By default, enriches rows with image-based DeepFace analysis
• By default, enriches rows with name-based gender and ethnicity predictions

Expected input shapes

The LinkedIn file should be a top-level JSON list of member records and must include either wordpress_user_id or user_id.

The sessions file should be a top-level JSON object with a sessions key whose value is a list. Each session record must include at least user_id and session_id.

Install

pip install -e .

Optional extras:

pip install -e ".[image]"
pip install -e ".[names]"
pip install -e ".[image,names]"

CLI usage

jcp-data-manager ^
  --sessions .\jcpst-sessions-2026-04-07-22-48-30.json ^
  --linkedin .\linkedin-member-data-2026-04-07-224846.json ^
  --output .\merged.parquet

You can also run it as a module:

python -m jcp_data_manager.cli --help

To skip an enrichment step, use --skip-image-analysis or --skip-name-analysis.

Project layout

src/jcp_data_manager/
  __init__.py
  cli.py
  enrichment.py
  io.py
  merge.py

The notebook was left untouched so you can compare outputs while you migrate.